souleyez 2.43.28__py3-none-any.whl → 2.43.32__py3-none-any.whl

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 (356) hide show
  1. souleyez/__init__.py +1 -2
  2. souleyez/ai/__init__.py +21 -15
  3. souleyez/ai/action_mapper.py +249 -150
  4. souleyez/ai/chain_advisor.py +116 -100
  5. souleyez/ai/claude_provider.py +29 -28
  6. souleyez/ai/context_builder.py +80 -62
  7. souleyez/ai/executor.py +158 -117
  8. souleyez/ai/feedback_handler.py +136 -121
  9. souleyez/ai/llm_factory.py +27 -20
  10. souleyez/ai/llm_provider.py +4 -2
  11. souleyez/ai/ollama_provider.py +6 -9
  12. souleyez/ai/ollama_service.py +44 -37
  13. souleyez/ai/path_scorer.py +91 -76
  14. souleyez/ai/recommender.py +176 -144
  15. souleyez/ai/report_context.py +74 -73
  16. souleyez/ai/report_service.py +84 -66
  17. souleyez/ai/result_parser.py +222 -229
  18. souleyez/ai/safety.py +67 -44
  19. souleyez/auth/__init__.py +23 -22
  20. souleyez/auth/audit.py +36 -26
  21. souleyez/auth/engagement_access.py +65 -48
  22. souleyez/auth/permissions.py +14 -3
  23. souleyez/auth/session_manager.py +54 -37
  24. souleyez/auth/user_manager.py +109 -64
  25. souleyez/commands/audit.py +40 -43
  26. souleyez/commands/auth.py +35 -15
  27. souleyez/commands/deliverables.py +55 -50
  28. souleyez/commands/engagement.py +47 -28
  29. souleyez/commands/license.py +32 -23
  30. souleyez/commands/screenshots.py +36 -32
  31. souleyez/commands/user.py +82 -36
  32. souleyez/config.py +52 -44
  33. souleyez/core/credential_tester.py +87 -81
  34. souleyez/core/cve_mappings.py +179 -192
  35. souleyez/core/cve_matcher.py +162 -148
  36. souleyez/core/msf_auto_mapper.py +100 -83
  37. souleyez/core/msf_chain_engine.py +294 -256
  38. souleyez/core/msf_database.py +153 -70
  39. souleyez/core/msf_integration.py +679 -673
  40. souleyez/core/msf_rpc_client.py +40 -42
  41. souleyez/core/msf_rpc_manager.py +77 -79
  42. souleyez/core/msf_sync_manager.py +241 -181
  43. souleyez/core/network_utils.py +22 -15
  44. souleyez/core/parser_handler.py +34 -25
  45. souleyez/core/pending_chains.py +114 -63
  46. souleyez/core/templates.py +158 -107
  47. souleyez/core/tool_chaining.py +9592 -2879
  48. souleyez/core/version_utils.py +79 -94
  49. souleyez/core/vuln_correlation.py +136 -89
  50. souleyez/core/web_utils.py +33 -32
  51. souleyez/data/wordlists/ad_users.txt +378 -0
  52. souleyez/data/wordlists/api_endpoints_large.txt +769 -0
  53. souleyez/data/wordlists/home_dir_sensitive.txt +39 -0
  54. souleyez/data/wordlists/lfi_payloads.txt +82 -0
  55. souleyez/data/wordlists/passwords_brute.txt +1548 -0
  56. souleyez/data/wordlists/passwords_crack.txt +2479 -0
  57. souleyez/data/wordlists/passwords_spray.txt +386 -0
  58. souleyez/data/wordlists/subdomains_large.txt +5057 -0
  59. souleyez/data/wordlists/usernames_common.txt +694 -0
  60. souleyez/data/wordlists/web_dirs_large.txt +4769 -0
  61. souleyez/detection/__init__.py +1 -1
  62. souleyez/detection/attack_signatures.py +12 -17
  63. souleyez/detection/mitre_mappings.py +61 -55
  64. souleyez/detection/validator.py +97 -86
  65. souleyez/devtools.py +23 -10
  66. souleyez/docs/README.md +4 -4
  67. souleyez/docs/api-reference/cli-commands.md +2 -2
  68. souleyez/docs/developer-guide/adding-new-tools.md +562 -0
  69. souleyez/docs/user-guide/auto-chaining.md +30 -8
  70. souleyez/docs/user-guide/getting-started.md +1 -1
  71. souleyez/docs/user-guide/installation.md +26 -3
  72. souleyez/docs/user-guide/metasploit-integration.md +2 -2
  73. souleyez/docs/user-guide/rbac.md +1 -1
  74. souleyez/docs/user-guide/scope-management.md +1 -1
  75. souleyez/docs/user-guide/siem-integration.md +1 -1
  76. souleyez/docs/user-guide/tools-reference.md +1 -8
  77. souleyez/docs/user-guide/worker-management.md +1 -1
  78. souleyez/engine/background.py +1238 -535
  79. souleyez/engine/base.py +4 -1
  80. souleyez/engine/job_status.py +17 -49
  81. souleyez/engine/log_sanitizer.py +103 -77
  82. souleyez/engine/manager.py +38 -7
  83. souleyez/engine/result_handler.py +2198 -1550
  84. souleyez/engine/worker_manager.py +50 -41
  85. souleyez/export/evidence_bundle.py +72 -62
  86. souleyez/feature_flags/features.py +16 -20
  87. souleyez/feature_flags.py +5 -9
  88. souleyez/handlers/__init__.py +11 -0
  89. souleyez/handlers/base.py +188 -0
  90. souleyez/handlers/bash_handler.py +277 -0
  91. souleyez/handlers/bloodhound_handler.py +243 -0
  92. souleyez/handlers/certipy_handler.py +311 -0
  93. souleyez/handlers/crackmapexec_handler.py +486 -0
  94. souleyez/handlers/dnsrecon_handler.py +344 -0
  95. souleyez/handlers/enum4linux_handler.py +400 -0
  96. souleyez/handlers/evil_winrm_handler.py +493 -0
  97. souleyez/handlers/ffuf_handler.py +815 -0
  98. souleyez/handlers/gobuster_handler.py +1114 -0
  99. souleyez/handlers/gpp_extract_handler.py +334 -0
  100. souleyez/handlers/hashcat_handler.py +444 -0
  101. souleyez/handlers/hydra_handler.py +563 -0
  102. souleyez/handlers/impacket_getuserspns_handler.py +343 -0
  103. souleyez/handlers/impacket_psexec_handler.py +222 -0
  104. souleyez/handlers/impacket_secretsdump_handler.py +426 -0
  105. souleyez/handlers/john_handler.py +286 -0
  106. souleyez/handlers/katana_handler.py +425 -0
  107. souleyez/handlers/kerbrute_handler.py +298 -0
  108. souleyez/handlers/ldapsearch_handler.py +636 -0
  109. souleyez/handlers/lfi_extract_handler.py +464 -0
  110. souleyez/handlers/msf_auxiliary_handler.py +408 -0
  111. souleyez/handlers/msf_exploit_handler.py +380 -0
  112. souleyez/handlers/nikto_handler.py +413 -0
  113. souleyez/handlers/nmap_handler.py +821 -0
  114. souleyez/handlers/nuclei_handler.py +359 -0
  115. souleyez/handlers/nxc_handler.py +371 -0
  116. souleyez/handlers/rdp_sec_check_handler.py +353 -0
  117. souleyez/handlers/registry.py +288 -0
  118. souleyez/handlers/responder_handler.py +232 -0
  119. souleyez/handlers/service_explorer_handler.py +434 -0
  120. souleyez/handlers/smbclient_handler.py +344 -0
  121. souleyez/handlers/smbmap_handler.py +510 -0
  122. souleyez/handlers/smbpasswd_handler.py +296 -0
  123. souleyez/handlers/sqlmap_handler.py +1116 -0
  124. souleyez/handlers/theharvester_handler.py +601 -0
  125. souleyez/handlers/whois_handler.py +277 -0
  126. souleyez/handlers/wpscan_handler.py +554 -0
  127. souleyez/history.py +32 -16
  128. souleyez/importers/msf_importer.py +106 -75
  129. souleyez/importers/smart_importer.py +208 -147
  130. souleyez/integrations/siem/__init__.py +10 -10
  131. souleyez/integrations/siem/base.py +17 -18
  132. souleyez/integrations/siem/elastic.py +108 -122
  133. souleyez/integrations/siem/factory.py +207 -80
  134. souleyez/integrations/siem/googlesecops.py +146 -154
  135. souleyez/integrations/siem/rule_mappings/__init__.py +1 -1
  136. souleyez/integrations/siem/rule_mappings/wazuh_rules.py +8 -5
  137. souleyez/integrations/siem/sentinel.py +107 -109
  138. souleyez/integrations/siem/splunk.py +246 -212
  139. souleyez/integrations/siem/wazuh.py +65 -71
  140. souleyez/integrations/wazuh/__init__.py +5 -5
  141. souleyez/integrations/wazuh/client.py +70 -93
  142. souleyez/integrations/wazuh/config.py +85 -57
  143. souleyez/integrations/wazuh/host_mapper.py +28 -36
  144. souleyez/integrations/wazuh/sync.py +78 -68
  145. souleyez/intelligence/__init__.py +4 -5
  146. souleyez/intelligence/correlation_analyzer.py +309 -295
  147. souleyez/intelligence/exploit_knowledge.py +661 -623
  148. souleyez/intelligence/exploit_suggestions.py +159 -139
  149. souleyez/intelligence/gap_analyzer.py +132 -97
  150. souleyez/intelligence/gap_detector.py +251 -214
  151. souleyez/intelligence/sensitive_tables.py +266 -129
  152. souleyez/intelligence/service_parser.py +137 -123
  153. souleyez/intelligence/surface_analyzer.py +407 -268
  154. souleyez/intelligence/target_parser.py +159 -162
  155. souleyez/licensing/__init__.py +6 -6
  156. souleyez/licensing/validator.py +17 -19
  157. souleyez/log_config.py +79 -54
  158. souleyez/main.py +1505 -687
  159. souleyez/migrations/fix_job_counter.py +16 -14
  160. souleyez/parsers/bloodhound_parser.py +41 -39
  161. souleyez/parsers/crackmapexec_parser.py +178 -111
  162. souleyez/parsers/dalfox_parser.py +72 -77
  163. souleyez/parsers/dnsrecon_parser.py +103 -91
  164. souleyez/parsers/enum4linux_parser.py +183 -153
  165. souleyez/parsers/ffuf_parser.py +29 -25
  166. souleyez/parsers/gobuster_parser.py +301 -41
  167. souleyez/parsers/hashcat_parser.py +324 -79
  168. souleyez/parsers/http_fingerprint_parser.py +350 -103
  169. souleyez/parsers/hydra_parser.py +131 -111
  170. souleyez/parsers/impacket_parser.py +231 -178
  171. souleyez/parsers/john_parser.py +98 -86
  172. souleyez/parsers/katana_parser.py +316 -0
  173. souleyez/parsers/msf_parser.py +943 -498
  174. souleyez/parsers/nikto_parser.py +346 -65
  175. souleyez/parsers/nmap_parser.py +262 -174
  176. souleyez/parsers/nuclei_parser.py +40 -44
  177. souleyez/parsers/responder_parser.py +26 -26
  178. souleyez/parsers/searchsploit_parser.py +74 -74
  179. souleyez/parsers/service_explorer_parser.py +279 -0
  180. souleyez/parsers/smbmap_parser.py +180 -124
  181. souleyez/parsers/sqlmap_parser.py +434 -308
  182. souleyez/parsers/theharvester_parser.py +75 -57
  183. souleyez/parsers/whois_parser.py +135 -94
  184. souleyez/parsers/wpscan_parser.py +278 -190
  185. souleyez/plugins/afp.py +44 -36
  186. souleyez/plugins/afp_brute.py +114 -46
  187. souleyez/plugins/ard.py +48 -37
  188. souleyez/plugins/bloodhound.py +95 -61
  189. souleyez/plugins/certipy.py +303 -0
  190. souleyez/plugins/crackmapexec.py +186 -85
  191. souleyez/plugins/dalfox.py +120 -59
  192. souleyez/plugins/dns_hijack.py +146 -41
  193. souleyez/plugins/dnsrecon.py +97 -61
  194. souleyez/plugins/enum4linux.py +91 -66
  195. souleyez/plugins/evil_winrm.py +291 -0
  196. souleyez/plugins/ffuf.py +166 -90
  197. souleyez/plugins/firmware_extract.py +133 -29
  198. souleyez/plugins/gobuster.py +387 -190
  199. souleyez/plugins/gpp_extract.py +393 -0
  200. souleyez/plugins/hashcat.py +100 -73
  201. souleyez/plugins/http_fingerprint.py +854 -267
  202. souleyez/plugins/hydra.py +566 -200
  203. souleyez/plugins/impacket_getnpusers.py +117 -69
  204. souleyez/plugins/impacket_psexec.py +84 -64
  205. souleyez/plugins/impacket_secretsdump.py +103 -69
  206. souleyez/plugins/impacket_smbclient.py +89 -75
  207. souleyez/plugins/john.py +86 -69
  208. souleyez/plugins/katana.py +313 -0
  209. souleyez/plugins/kerbrute.py +237 -0
  210. souleyez/plugins/lfi_extract.py +541 -0
  211. souleyez/plugins/macos_ssh.py +117 -48
  212. souleyez/plugins/mdns.py +35 -30
  213. souleyez/plugins/msf_auxiliary.py +253 -130
  214. souleyez/plugins/msf_exploit.py +239 -161
  215. souleyez/plugins/nikto.py +134 -78
  216. souleyez/plugins/nmap.py +275 -91
  217. souleyez/plugins/nuclei.py +180 -89
  218. souleyez/plugins/nxc.py +285 -0
  219. souleyez/plugins/plugin_base.py +35 -36
  220. souleyez/plugins/plugin_template.py +13 -5
  221. souleyez/plugins/rdp_sec_check.py +130 -0
  222. souleyez/plugins/responder.py +112 -71
  223. souleyez/plugins/router_http_brute.py +76 -65
  224. souleyez/plugins/router_ssh_brute.py +118 -41
  225. souleyez/plugins/router_telnet_brute.py +124 -42
  226. souleyez/plugins/routersploit.py +91 -59
  227. souleyez/plugins/routersploit_exploit.py +77 -55
  228. souleyez/plugins/searchsploit.py +91 -77
  229. souleyez/plugins/service_explorer.py +1160 -0
  230. souleyez/plugins/smbmap.py +122 -72
  231. souleyez/plugins/smbpasswd.py +215 -0
  232. souleyez/plugins/sqlmap.py +301 -113
  233. souleyez/plugins/theharvester.py +127 -75
  234. souleyez/plugins/tr069.py +79 -57
  235. souleyez/plugins/upnp.py +65 -47
  236. souleyez/plugins/upnp_abuse.py +73 -55
  237. souleyez/plugins/vnc_access.py +129 -42
  238. souleyez/plugins/vnc_brute.py +109 -38
  239. souleyez/plugins/whois.py +77 -58
  240. souleyez/plugins/wpscan.py +173 -69
  241. souleyez/reporting/__init__.py +2 -1
  242. souleyez/reporting/attack_chain.py +411 -346
  243. souleyez/reporting/charts.py +436 -501
  244. souleyez/reporting/compliance_mappings.py +334 -201
  245. souleyez/reporting/detection_report.py +126 -125
  246. souleyez/reporting/formatters.py +828 -591
  247. souleyez/reporting/generator.py +386 -302
  248. souleyez/reporting/metrics.py +72 -75
  249. souleyez/scanner.py +35 -29
  250. souleyez/security/__init__.py +37 -11
  251. souleyez/security/scope_validator.py +175 -106
  252. souleyez/security/validation.py +223 -149
  253. souleyez/security.py +22 -6
  254. souleyez/storage/credentials.py +247 -186
  255. souleyez/storage/crypto.py +296 -129
  256. souleyez/storage/database.py +73 -50
  257. souleyez/storage/db.py +58 -36
  258. souleyez/storage/deliverable_evidence.py +177 -128
  259. souleyez/storage/deliverable_exporter.py +282 -246
  260. souleyez/storage/deliverable_templates.py +134 -116
  261. souleyez/storage/deliverables.py +135 -130
  262. souleyez/storage/engagements.py +109 -56
  263. souleyez/storage/evidence.py +181 -152
  264. souleyez/storage/execution_log.py +31 -17
  265. souleyez/storage/exploit_attempts.py +93 -57
  266. souleyez/storage/exploits.py +67 -36
  267. souleyez/storage/findings.py +48 -61
  268. souleyez/storage/hosts.py +176 -144
  269. souleyez/storage/migrate_to_engagements.py +43 -19
  270. souleyez/storage/migrations/_001_add_credential_enhancements.py +22 -12
  271. souleyez/storage/migrations/_002_add_status_tracking.py +10 -7
  272. souleyez/storage/migrations/_003_add_execution_log.py +14 -8
  273. souleyez/storage/migrations/_005_screenshots.py +13 -5
  274. souleyez/storage/migrations/_006_deliverables.py +13 -5
  275. souleyez/storage/migrations/_007_deliverable_templates.py +12 -7
  276. souleyez/storage/migrations/_008_add_nuclei_table.py +10 -4
  277. souleyez/storage/migrations/_010_evidence_linking.py +17 -10
  278. souleyez/storage/migrations/_011_timeline_tracking.py +20 -13
  279. souleyez/storage/migrations/_012_team_collaboration.py +34 -21
  280. souleyez/storage/migrations/_013_add_host_tags.py +12 -6
  281. souleyez/storage/migrations/_014_exploit_attempts.py +22 -10
  282. souleyez/storage/migrations/_015_add_mac_os_fields.py +15 -7
  283. souleyez/storage/migrations/_016_add_domain_field.py +10 -4
  284. souleyez/storage/migrations/_017_msf_sessions.py +16 -8
  285. souleyez/storage/migrations/_018_add_osint_target.py +10 -6
  286. souleyez/storage/migrations/_019_add_engagement_type.py +10 -6
  287. souleyez/storage/migrations/_020_add_rbac.py +36 -15
  288. souleyez/storage/migrations/_021_wazuh_integration.py +20 -8
  289. souleyez/storage/migrations/_022_wazuh_indexer_columns.py +6 -4
  290. souleyez/storage/migrations/_023_fix_detection_results_fk.py +16 -6
  291. souleyez/storage/migrations/_024_wazuh_vulnerabilities.py +26 -10
  292. souleyez/storage/migrations/_025_multi_siem_support.py +3 -5
  293. souleyez/storage/migrations/_026_add_engagement_scope.py +31 -12
  294. souleyez/storage/migrations/_027_multi_siem_persistence.py +32 -15
  295. souleyez/storage/migrations/__init__.py +26 -26
  296. souleyez/storage/migrations/migration_manager.py +19 -19
  297. souleyez/storage/msf_sessions.py +100 -65
  298. souleyez/storage/osint.py +17 -24
  299. souleyez/storage/recommendation_engine.py +269 -235
  300. souleyez/storage/screenshots.py +33 -32
  301. souleyez/storage/smb_shares.py +136 -92
  302. souleyez/storage/sqlmap_data.py +183 -128
  303. souleyez/storage/team_collaboration.py +135 -141
  304. souleyez/storage/timeline_tracker.py +122 -94
  305. souleyez/storage/wazuh_vulns.py +64 -66
  306. souleyez/storage/web_paths.py +33 -37
  307. souleyez/testing/credential_tester.py +221 -205
  308. souleyez/ui/__init__.py +1 -1
  309. souleyez/ui/ai_quotes.py +12 -12
  310. souleyez/ui/attack_surface.py +2439 -1516
  311. souleyez/ui/chain_rules_view.py +914 -382
  312. souleyez/ui/correlation_view.py +312 -230
  313. souleyez/ui/dashboard.py +2382 -1130
  314. souleyez/ui/deliverables_view.py +148 -62
  315. souleyez/ui/design_system.py +13 -13
  316. souleyez/ui/errors.py +49 -49
  317. souleyez/ui/evidence_linking_view.py +284 -179
  318. souleyez/ui/evidence_vault.py +393 -285
  319. souleyez/ui/exploit_suggestions_view.py +555 -349
  320. souleyez/ui/export_view.py +100 -66
  321. souleyez/ui/gap_analysis_view.py +315 -171
  322. souleyez/ui/help_system.py +105 -97
  323. souleyez/ui/intelligence_view.py +436 -293
  324. souleyez/ui/interactive.py +23142 -10430
  325. souleyez/ui/interactive_selector.py +75 -68
  326. souleyez/ui/log_formatter.py +47 -39
  327. souleyez/ui/menu_components.py +22 -13
  328. souleyez/ui/msf_auxiliary_menu.py +184 -133
  329. souleyez/ui/pending_chains_view.py +336 -172
  330. souleyez/ui/progress_indicators.py +5 -3
  331. souleyez/ui/recommendations_view.py +195 -137
  332. souleyez/ui/rule_builder.py +343 -225
  333. souleyez/ui/setup_wizard.py +678 -284
  334. souleyez/ui/shortcuts.py +217 -165
  335. souleyez/ui/splunk_gap_analysis_view.py +452 -270
  336. souleyez/ui/splunk_vulns_view.py +139 -86
  337. souleyez/ui/team_dashboard.py +498 -335
  338. souleyez/ui/template_selector.py +196 -105
  339. souleyez/ui/terminal.py +6 -6
  340. souleyez/ui/timeline_view.py +198 -127
  341. souleyez/ui/tool_setup.py +264 -164
  342. souleyez/ui/tutorial.py +202 -72
  343. souleyez/ui/tutorial_state.py +40 -40
  344. souleyez/ui/wazuh_vulns_view.py +235 -141
  345. souleyez/ui/wordlist_browser.py +260 -107
  346. souleyez/ui.py +464 -312
  347. souleyez/utils/tool_checker.py +427 -367
  348. souleyez/utils.py +33 -29
  349. souleyez/wordlists.py +134 -167
  350. {souleyez-2.43.28.dist-info → souleyez-2.43.32.dist-info}/METADATA +1 -1
  351. souleyez-2.43.32.dist-info/RECORD +441 -0
  352. {souleyez-2.43.28.dist-info → souleyez-2.43.32.dist-info}/WHEEL +1 -1
  353. souleyez-2.43.28.dist-info/RECORD +0 -379
  354. {souleyez-2.43.28.dist-info → souleyez-2.43.32.dist-info}/entry_points.txt +0 -0
  355. {souleyez-2.43.28.dist-info → souleyez-2.43.32.dist-info}/licenses/LICENSE +0 -0
  356. {souleyez-2.43.28.dist-info → souleyez-2.43.32.dist-info}/top_level.txt +0 -0
@@ -1,6 +1,7 @@
1
1
  """
2
2
  Deliverable templates management.
3
3
  """
4
+
4
5
  from typing import List, Dict, Optional
5
6
  import json
6
7
  import os
@@ -9,93 +10,97 @@ from .database import get_db
9
10
 
10
11
  class TemplateManager:
11
12
  """Manage deliverable templates."""
12
-
13
+
13
14
  def __init__(self):
14
15
  self.db = get_db()
15
16
  self._ensure_builtin_templates()
16
-
17
+
17
18
  def _ensure_builtin_templates(self):
18
19
  """Load built-in templates from JSON files if not already loaded."""
19
20
  # Get list of existing builtin template names
20
21
  existing = self.db.execute(
21
22
  "SELECT name FROM deliverable_templates WHERE is_builtin = 1"
22
23
  )
23
- existing_names = {t['name'] for t in existing} if existing else set()
24
-
24
+ existing_names = {t["name"] for t in existing} if existing else set()
25
+
25
26
  # Load built-in templates from data/templates/
26
27
  templates_dir = self._get_templates_dir()
27
-
28
+
28
29
  builtin_templates = [
29
30
  # Original templates
30
- 'pci_dss_4.0.json',
31
- 'owasp_top10_2021.json',
32
- 'hipaa_security.json',
33
- 'nist_csf.json',
31
+ "pci_dss_4.0.json",
32
+ "owasp_top10_2021.json",
33
+ "hipaa_security.json",
34
+ "nist_csf.json",
34
35
  # Compliance Frameworks
35
- 'soc2_type2.json',
36
- 'iso27001.json',
37
- 'cis_controls_v8.json',
38
- 'cmmc_2.0.json',
39
- 'gdpr_article32.json',
40
- 'glba_safeguards.json',
36
+ "soc2_type2.json",
37
+ "iso27001.json",
38
+ "cis_controls_v8.json",
39
+ "cmmc_2.0.json",
40
+ "gdpr_article32.json",
41
+ "glba_safeguards.json",
41
42
  # Pentest Methodologies
42
- 'ptes_standard.json',
43
- 'internal_network.json',
44
- 'external_network.json',
45
- 'webapp_advanced.json',
46
- 'red_team.json',
47
- 'cloud_security.json',
48
- 'active_directory.json',
43
+ "ptes_standard.json",
44
+ "internal_network.json",
45
+ "external_network.json",
46
+ "webapp_advanced.json",
47
+ "red_team.json",
48
+ "cloud_security.json",
49
+ "active_directory.json",
49
50
  # Industry-Specific
50
- 'nerc_cip.json',
51
- 'hitrust_csf.json',
52
- 'ffiec_cat.json'
51
+ "nerc_cip.json",
52
+ "hitrust_csf.json",
53
+ "ffiec_cat.json",
53
54
  ]
54
-
55
+
55
56
  for template_file in builtin_templates:
56
57
  template_path = os.path.join(templates_dir, template_file)
57
58
  if os.path.exists(template_path):
58
59
  try:
59
- with open(template_path, 'r') as f:
60
+ with open(template_path, "r") as f:
60
61
  template_data = json.load(f)
61
62
 
62
63
  # Skip if template already exists
63
- if template_data['name'] in existing_names:
64
+ if template_data["name"] in existing_names:
64
65
  continue
65
66
 
66
67
  self.create_template(
67
- name=template_data['name'],
68
- description=template_data.get('description'),
69
- framework=template_data.get('framework'),
70
- engagement_type=template_data.get('engagement_type'),
71
- deliverables=template_data['deliverables'],
72
- is_builtin=True
68
+ name=template_data["name"],
69
+ description=template_data.get("description"),
70
+ framework=template_data.get("framework"),
71
+ engagement_type=template_data.get("engagement_type"),
72
+ deliverables=template_data["deliverables"],
73
+ is_builtin=True,
73
74
  )
74
75
  except Exception as e:
75
76
  print(f"⚠️ Failed to load template {template_file}: {e}")
76
-
77
+
77
78
  def _get_templates_dir(self) -> str:
78
79
  """Get path to templates directory across all installation types."""
79
80
  import sys
80
81
  from pathlib import Path
81
82
 
82
83
  # Check environment variable first
83
- env_root = os.environ.get('SOULEYEZ_ROOT')
84
+ env_root = os.environ.get("SOULEYEZ_ROOT")
84
85
  if env_root:
85
- env_path = os.path.join(env_root, 'data', 'templates')
86
+ env_path = os.path.join(env_root, "data", "templates")
86
87
  if os.path.isdir(env_path):
87
88
  return env_path
88
89
 
89
90
  # Possible locations in priority order
90
91
  possible_paths = [
91
92
  # Package bundled: souleyez/data/templates/
92
- os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), 'data', 'templates'),
93
+ os.path.join(
94
+ os.path.dirname(os.path.dirname(os.path.abspath(__file__))),
95
+ "data",
96
+ "templates",
97
+ ),
93
98
  # Debian package install
94
- '/usr/share/souleyez/templates',
99
+ "/usr/share/souleyez/templates",
95
100
  # User local install
96
- os.path.expanduser('~/.local/share/souleyez/templates'),
101
+ os.path.expanduser("~/.local/share/souleyez/templates"),
97
102
  # System-wide pip install
98
- os.path.join(sys.prefix, 'share', 'souleyez', 'templates'),
103
+ os.path.join(sys.prefix, "share", "souleyez", "templates"),
99
104
  ]
100
105
 
101
106
  for path in possible_paths:
@@ -104,7 +109,7 @@ class TemplateManager:
104
109
 
105
110
  # Fallback to development path (may not exist)
106
111
  return possible_paths[0]
107
-
112
+
108
113
  def create_template(
109
114
  self,
110
115
  name: str,
@@ -113,66 +118,68 @@ class TemplateManager:
113
118
  framework: str = None,
114
119
  engagement_type: str = None,
115
120
  created_by: str = None,
116
- is_builtin: bool = False
121
+ is_builtin: bool = False,
117
122
  ) -> int:
118
123
  """Create a new deliverable template."""
119
124
  deliverables_json = json.dumps(deliverables)
120
-
121
- template_id = self.db.insert('deliverable_templates', {
122
- 'name': name,
123
- 'description': description,
124
- 'framework': framework,
125
- 'engagement_type': engagement_type,
126
- 'deliverables_json': deliverables_json,
127
- 'created_by': created_by,
128
- 'is_builtin': 1 if is_builtin else 0
129
- })
130
-
125
+
126
+ template_id = self.db.insert(
127
+ "deliverable_templates",
128
+ {
129
+ "name": name,
130
+ "description": description,
131
+ "framework": framework,
132
+ "engagement_type": engagement_type,
133
+ "deliverables_json": deliverables_json,
134
+ "created_by": created_by,
135
+ "is_builtin": 1 if is_builtin else 0,
136
+ },
137
+ )
138
+
131
139
  return template_id
132
-
140
+
133
141
  def get_template(self, template_id: int) -> Optional[Dict]:
134
142
  """Get template by ID."""
135
143
  template = self.db.execute_one(
136
- "SELECT * FROM deliverable_templates WHERE id = ?",
137
- (template_id,)
144
+ "SELECT * FROM deliverable_templates WHERE id = ?", (template_id,)
138
145
  )
139
-
146
+
140
147
  if template:
141
- template['deliverables'] = json.loads(template['deliverables_json'])
142
-
148
+ template["deliverables"] = json.loads(template["deliverables_json"])
149
+
143
150
  return template
144
-
151
+
145
152
  def list_templates(
146
153
  self,
147
154
  framework: str = None,
148
155
  engagement_type: str = None,
149
- include_custom: bool = True
156
+ include_custom: bool = True,
150
157
  ) -> List[Dict]:
151
158
  """List available templates."""
152
159
  query = "SELECT * FROM deliverable_templates WHERE 1=1"
153
160
  params = []
154
-
161
+
155
162
  if framework:
156
163
  query += " AND framework = ?"
157
164
  params.append(framework)
158
-
165
+
159
166
  if engagement_type:
160
167
  query += " AND engagement_type = ?"
161
168
  params.append(engagement_type)
162
-
169
+
163
170
  if not include_custom:
164
171
  query += " AND is_builtin = 1"
165
-
172
+
166
173
  query += " ORDER BY is_builtin DESC, name ASC"
167
-
174
+
168
175
  templates = self.db.execute(query, tuple(params))
169
-
176
+
170
177
  # Parse deliverables JSON for each
171
178
  for template in templates:
172
- template['deliverables'] = json.loads(template['deliverables_json'])
173
-
179
+ template["deliverables"] = json.loads(template["deliverables_json"])
180
+
174
181
  return templates
175
-
182
+
176
183
  def apply_template(self, template_id: int, engagement_id: int) -> int:
177
184
  """Apply a template to an engagement."""
178
185
  template = self.get_template(template_id)
@@ -180,12 +187,13 @@ class TemplateManager:
180
187
  raise ValueError(f"Template {template_id} not found")
181
188
 
182
189
  from .deliverables import DeliverableManager
190
+
183
191
  dm = DeliverableManager()
184
192
 
185
193
  count = 0
186
- for deliverable_config in template['deliverables']:
194
+ for deliverable_config in template["deliverables"]:
187
195
  # Inject engagement_id into validation queries
188
- validation_query = deliverable_config.get('validation_query')
196
+ validation_query = deliverable_config.get("validation_query")
189
197
  if validation_query:
190
198
  validation_query = self._inject_engagement_filter(
191
199
  validation_query, engagement_id
@@ -193,14 +201,14 @@ class TemplateManager:
193
201
 
194
202
  dm.add_deliverable(
195
203
  engagement_id=engagement_id,
196
- category=deliverable_config['category'],
197
- title=deliverable_config['title'],
198
- description=deliverable_config.get('description'),
199
- target_type=deliverable_config.get('target_type', 'manual'),
200
- target_value=deliverable_config.get('target_value'),
201
- auto_validate=deliverable_config.get('auto_validate', False),
204
+ category=deliverable_config["category"],
205
+ title=deliverable_config["title"],
206
+ description=deliverable_config.get("description"),
207
+ target_type=deliverable_config.get("target_type", "manual"),
208
+ target_value=deliverable_config.get("target_value"),
209
+ auto_validate=deliverable_config.get("auto_validate", False),
202
210
  validation_query=validation_query,
203
- priority=deliverable_config.get('priority', 'medium')
211
+ priority=deliverable_config.get("priority", "medium"),
204
212
  )
205
213
  count += 1
206
214
 
@@ -219,79 +227,89 @@ class TemplateManager:
219
227
  query_lower = query.lower()
220
228
 
221
229
  # For services table, need to join through hosts
222
- if 'from services' in query_lower and 'join' not in query_lower:
230
+ if "from services" in query_lower and "join" not in query_lower:
223
231
  # Replace "FROM services" with a JOIN to hosts
224
232
  query = re.sub(
225
- r'FROM\s+services\b',
226
- f'FROM services s JOIN hosts h ON s.host_id = h.id',
233
+ r"FROM\s+services\b",
234
+ f"FROM services s JOIN hosts h ON s.host_id = h.id",
227
235
  query,
228
- flags=re.IGNORECASE
236
+ flags=re.IGNORECASE,
229
237
  )
230
238
  # Add WHERE clause with engagement filter
231
- if 'where' in query_lower:
239
+ if "where" in query_lower:
232
240
  query = re.sub(
233
- r'\bWHERE\b',
234
- f'WHERE h.engagement_id = {engagement_id} AND',
241
+ r"\bWHERE\b",
242
+ f"WHERE h.engagement_id = {engagement_id} AND",
235
243
  query,
236
- flags=re.IGNORECASE
244
+ flags=re.IGNORECASE,
237
245
  )
238
246
  else:
239
- query += f' WHERE h.engagement_id = {engagement_id}'
247
+ query += f" WHERE h.engagement_id = {engagement_id}"
240
248
  # For tables with direct engagement_id column
241
- elif any(table in query_lower for table in ['from hosts', 'from findings', 'from credentials', 'from osint_data']):
242
- if 'where' in query_lower:
249
+ elif any(
250
+ table in query_lower
251
+ for table in [
252
+ "from hosts",
253
+ "from findings",
254
+ "from credentials",
255
+ "from osint_data",
256
+ ]
257
+ ):
258
+ if "where" in query_lower:
243
259
  query = re.sub(
244
- r'\bWHERE\b',
245
- f'WHERE engagement_id = {engagement_id} AND',
260
+ r"\bWHERE\b",
261
+ f"WHERE engagement_id = {engagement_id} AND",
246
262
  query,
247
- flags=re.IGNORECASE
263
+ flags=re.IGNORECASE,
248
264
  )
249
265
  else:
250
- query += f' WHERE engagement_id = {engagement_id}'
266
+ query += f" WHERE engagement_id = {engagement_id}"
251
267
 
252
268
  return query
253
-
269
+
254
270
  def delete_template(self, template_id: int) -> bool:
255
271
  """Delete a custom template (cannot delete built-in)."""
256
272
  template = self.get_template(template_id)
257
273
  if not template:
258
274
  return False
259
-
260
- if template['is_builtin']:
275
+
276
+ if template["is_builtin"]:
261
277
  raise ValueError("Cannot delete built-in templates")
262
-
263
- self.db.execute("DELETE FROM deliverable_templates WHERE id = ?", (template_id,))
278
+
279
+ self.db.execute(
280
+ "DELETE FROM deliverable_templates WHERE id = ?", (template_id,)
281
+ )
264
282
  return True
265
-
283
+
266
284
  def export_template(self, template_id: int) -> str:
267
285
  """Export template as JSON string."""
268
286
  template = self.get_template(template_id)
269
287
  if not template:
270
288
  raise ValueError(f"Template {template_id} not found")
271
-
289
+
272
290
  export_data = {
273
- 'name': template['name'],
274
- 'description': template['description'],
275
- 'framework': template['framework'],
276
- 'engagement_type': template['engagement_type'],
277
- 'deliverables': template['deliverables']
291
+ "name": template["name"],
292
+ "description": template["description"],
293
+ "framework": template["framework"],
294
+ "engagement_type": template["engagement_type"],
295
+ "deliverables": template["deliverables"],
278
296
  }
279
-
297
+
280
298
  return json.dumps(export_data, indent=2)
281
-
299
+
282
300
  def import_template(self, json_data: str, created_by: str = None) -> int:
283
301
  """Import template from JSON string."""
284
302
  try:
285
303
  template_data = json.loads(json_data)
286
-
304
+
287
305
  return self.create_template(
288
- name=template_data['name'],
289
- description=template_data.get('description'),
290
- framework=template_data.get('framework'),
291
- engagement_type=template_data.get('engagement_type'),
292
- deliverables=template_data['deliverables'],
306
+ name=template_data["name"],
307
+ description=template_data.get("description"),
308
+ framework=template_data.get("framework"),
309
+ engagement_type=template_data.get("engagement_type"),
310
+ deliverables=template_data["deliverables"],
293
311
  created_by=created_by,
294
- is_builtin=False
312
+ is_builtin=False,
295
313
  )
296
314
  except Exception as e:
297
315
  raise ValueError(f"Failed to import template: {e}")