souleyez 2.43.26__py3-none-any.whl → 2.43.34__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 (358) 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 +9526 -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 +1239 -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 +2200 -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 +292 -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/web_login_test_handler.py +327 -0
  126. souleyez/handlers/whois_handler.py +277 -0
  127. souleyez/handlers/wpscan_handler.py +554 -0
  128. souleyez/history.py +32 -16
  129. souleyez/importers/msf_importer.py +106 -75
  130. souleyez/importers/smart_importer.py +208 -147
  131. souleyez/integrations/siem/__init__.py +10 -10
  132. souleyez/integrations/siem/base.py +17 -18
  133. souleyez/integrations/siem/elastic.py +108 -122
  134. souleyez/integrations/siem/factory.py +207 -80
  135. souleyez/integrations/siem/googlesecops.py +146 -154
  136. souleyez/integrations/siem/rule_mappings/__init__.py +1 -1
  137. souleyez/integrations/siem/rule_mappings/wazuh_rules.py +8 -5
  138. souleyez/integrations/siem/sentinel.py +107 -109
  139. souleyez/integrations/siem/splunk.py +246 -212
  140. souleyez/integrations/siem/wazuh.py +65 -71
  141. souleyez/integrations/wazuh/__init__.py +5 -5
  142. souleyez/integrations/wazuh/client.py +70 -93
  143. souleyez/integrations/wazuh/config.py +85 -57
  144. souleyez/integrations/wazuh/host_mapper.py +28 -36
  145. souleyez/integrations/wazuh/sync.py +78 -68
  146. souleyez/intelligence/__init__.py +4 -5
  147. souleyez/intelligence/correlation_analyzer.py +309 -295
  148. souleyez/intelligence/exploit_knowledge.py +661 -623
  149. souleyez/intelligence/exploit_suggestions.py +159 -139
  150. souleyez/intelligence/gap_analyzer.py +132 -97
  151. souleyez/intelligence/gap_detector.py +251 -214
  152. souleyez/intelligence/sensitive_tables.py +266 -129
  153. souleyez/intelligence/service_parser.py +137 -123
  154. souleyez/intelligence/surface_analyzer.py +407 -268
  155. souleyez/intelligence/target_parser.py +159 -162
  156. souleyez/licensing/__init__.py +6 -6
  157. souleyez/licensing/validator.py +17 -19
  158. souleyez/log_config.py +79 -54
  159. souleyez/main.py +1505 -687
  160. souleyez/migrations/fix_job_counter.py +16 -14
  161. souleyez/parsers/bloodhound_parser.py +41 -39
  162. souleyez/parsers/crackmapexec_parser.py +178 -111
  163. souleyez/parsers/dalfox_parser.py +72 -77
  164. souleyez/parsers/dnsrecon_parser.py +103 -91
  165. souleyez/parsers/enum4linux_parser.py +183 -153
  166. souleyez/parsers/ffuf_parser.py +29 -25
  167. souleyez/parsers/gobuster_parser.py +301 -41
  168. souleyez/parsers/hashcat_parser.py +324 -79
  169. souleyez/parsers/http_fingerprint_parser.py +350 -103
  170. souleyez/parsers/hydra_parser.py +131 -111
  171. souleyez/parsers/impacket_parser.py +231 -178
  172. souleyez/parsers/john_parser.py +98 -86
  173. souleyez/parsers/katana_parser.py +316 -0
  174. souleyez/parsers/msf_parser.py +943 -498
  175. souleyez/parsers/nikto_parser.py +346 -65
  176. souleyez/parsers/nmap_parser.py +262 -174
  177. souleyez/parsers/nuclei_parser.py +40 -44
  178. souleyez/parsers/responder_parser.py +26 -26
  179. souleyez/parsers/searchsploit_parser.py +74 -74
  180. souleyez/parsers/service_explorer_parser.py +279 -0
  181. souleyez/parsers/smbmap_parser.py +180 -124
  182. souleyez/parsers/sqlmap_parser.py +434 -308
  183. souleyez/parsers/theharvester_parser.py +75 -57
  184. souleyez/parsers/whois_parser.py +135 -94
  185. souleyez/parsers/wpscan_parser.py +278 -190
  186. souleyez/plugins/afp.py +44 -36
  187. souleyez/plugins/afp_brute.py +114 -46
  188. souleyez/plugins/ard.py +48 -37
  189. souleyez/plugins/bloodhound.py +95 -61
  190. souleyez/plugins/certipy.py +303 -0
  191. souleyez/plugins/crackmapexec.py +186 -85
  192. souleyez/plugins/dalfox.py +120 -59
  193. souleyez/plugins/dns_hijack.py +146 -41
  194. souleyez/plugins/dnsrecon.py +97 -61
  195. souleyez/plugins/enum4linux.py +91 -66
  196. souleyez/plugins/evil_winrm.py +291 -0
  197. souleyez/plugins/ffuf.py +166 -90
  198. souleyez/plugins/firmware_extract.py +133 -29
  199. souleyez/plugins/gobuster.py +387 -190
  200. souleyez/plugins/gpp_extract.py +393 -0
  201. souleyez/plugins/hashcat.py +100 -73
  202. souleyez/plugins/http_fingerprint.py +854 -267
  203. souleyez/plugins/hydra.py +566 -200
  204. souleyez/plugins/impacket_getnpusers.py +117 -69
  205. souleyez/plugins/impacket_psexec.py +84 -64
  206. souleyez/plugins/impacket_secretsdump.py +103 -69
  207. souleyez/plugins/impacket_smbclient.py +89 -75
  208. souleyez/plugins/john.py +86 -69
  209. souleyez/plugins/katana.py +313 -0
  210. souleyez/plugins/kerbrute.py +237 -0
  211. souleyez/plugins/lfi_extract.py +541 -0
  212. souleyez/plugins/macos_ssh.py +117 -48
  213. souleyez/plugins/mdns.py +35 -30
  214. souleyez/plugins/msf_auxiliary.py +253 -130
  215. souleyez/plugins/msf_exploit.py +239 -161
  216. souleyez/plugins/nikto.py +134 -78
  217. souleyez/plugins/nmap.py +275 -91
  218. souleyez/plugins/nuclei.py +180 -89
  219. souleyez/plugins/nxc.py +285 -0
  220. souleyez/plugins/plugin_base.py +35 -36
  221. souleyez/plugins/plugin_template.py +13 -5
  222. souleyez/plugins/rdp_sec_check.py +130 -0
  223. souleyez/plugins/responder.py +112 -71
  224. souleyez/plugins/router_http_brute.py +76 -65
  225. souleyez/plugins/router_ssh_brute.py +118 -41
  226. souleyez/plugins/router_telnet_brute.py +124 -42
  227. souleyez/plugins/routersploit.py +91 -59
  228. souleyez/plugins/routersploit_exploit.py +77 -55
  229. souleyez/plugins/searchsploit.py +91 -77
  230. souleyez/plugins/service_explorer.py +1160 -0
  231. souleyez/plugins/smbmap.py +122 -72
  232. souleyez/plugins/smbpasswd.py +215 -0
  233. souleyez/plugins/sqlmap.py +301 -113
  234. souleyez/plugins/theharvester.py +127 -75
  235. souleyez/plugins/tr069.py +79 -57
  236. souleyez/plugins/upnp.py +65 -47
  237. souleyez/plugins/upnp_abuse.py +73 -55
  238. souleyez/plugins/vnc_access.py +129 -42
  239. souleyez/plugins/vnc_brute.py +109 -38
  240. souleyez/plugins/web_login_test.py +417 -0
  241. souleyez/plugins/whois.py +77 -58
  242. souleyez/plugins/wpscan.py +173 -69
  243. souleyez/reporting/__init__.py +2 -1
  244. souleyez/reporting/attack_chain.py +411 -346
  245. souleyez/reporting/charts.py +436 -501
  246. souleyez/reporting/compliance_mappings.py +334 -201
  247. souleyez/reporting/detection_report.py +126 -125
  248. souleyez/reporting/formatters.py +828 -591
  249. souleyez/reporting/generator.py +386 -302
  250. souleyez/reporting/metrics.py +72 -75
  251. souleyez/scanner.py +35 -29
  252. souleyez/security/__init__.py +37 -11
  253. souleyez/security/scope_validator.py +175 -106
  254. souleyez/security/validation.py +223 -149
  255. souleyez/security.py +22 -6
  256. souleyez/storage/credentials.py +247 -186
  257. souleyez/storage/crypto.py +296 -129
  258. souleyez/storage/database.py +73 -50
  259. souleyez/storage/db.py +58 -36
  260. souleyez/storage/deliverable_evidence.py +177 -128
  261. souleyez/storage/deliverable_exporter.py +282 -246
  262. souleyez/storage/deliverable_templates.py +134 -116
  263. souleyez/storage/deliverables.py +135 -130
  264. souleyez/storage/engagements.py +109 -56
  265. souleyez/storage/evidence.py +181 -152
  266. souleyez/storage/execution_log.py +31 -17
  267. souleyez/storage/exploit_attempts.py +93 -57
  268. souleyez/storage/exploits.py +67 -36
  269. souleyez/storage/findings.py +48 -61
  270. souleyez/storage/hosts.py +176 -144
  271. souleyez/storage/migrate_to_engagements.py +43 -19
  272. souleyez/storage/migrations/_001_add_credential_enhancements.py +22 -12
  273. souleyez/storage/migrations/_002_add_status_tracking.py +10 -7
  274. souleyez/storage/migrations/_003_add_execution_log.py +14 -8
  275. souleyez/storage/migrations/_005_screenshots.py +13 -5
  276. souleyez/storage/migrations/_006_deliverables.py +13 -5
  277. souleyez/storage/migrations/_007_deliverable_templates.py +12 -7
  278. souleyez/storage/migrations/_008_add_nuclei_table.py +10 -4
  279. souleyez/storage/migrations/_010_evidence_linking.py +17 -10
  280. souleyez/storage/migrations/_011_timeline_tracking.py +20 -13
  281. souleyez/storage/migrations/_012_team_collaboration.py +34 -21
  282. souleyez/storage/migrations/_013_add_host_tags.py +12 -6
  283. souleyez/storage/migrations/_014_exploit_attempts.py +22 -10
  284. souleyez/storage/migrations/_015_add_mac_os_fields.py +15 -7
  285. souleyez/storage/migrations/_016_add_domain_field.py +10 -4
  286. souleyez/storage/migrations/_017_msf_sessions.py +16 -8
  287. souleyez/storage/migrations/_018_add_osint_target.py +10 -6
  288. souleyez/storage/migrations/_019_add_engagement_type.py +10 -6
  289. souleyez/storage/migrations/_020_add_rbac.py +36 -15
  290. souleyez/storage/migrations/_021_wazuh_integration.py +20 -8
  291. souleyez/storage/migrations/_022_wazuh_indexer_columns.py +6 -4
  292. souleyez/storage/migrations/_023_fix_detection_results_fk.py +16 -6
  293. souleyez/storage/migrations/_024_wazuh_vulnerabilities.py +26 -10
  294. souleyez/storage/migrations/_025_multi_siem_support.py +3 -5
  295. souleyez/storage/migrations/_026_add_engagement_scope.py +31 -12
  296. souleyez/storage/migrations/_027_multi_siem_persistence.py +32 -15
  297. souleyez/storage/migrations/__init__.py +26 -26
  298. souleyez/storage/migrations/migration_manager.py +19 -19
  299. souleyez/storage/msf_sessions.py +100 -65
  300. souleyez/storage/osint.py +17 -24
  301. souleyez/storage/recommendation_engine.py +269 -235
  302. souleyez/storage/screenshots.py +33 -32
  303. souleyez/storage/smb_shares.py +136 -92
  304. souleyez/storage/sqlmap_data.py +183 -128
  305. souleyez/storage/team_collaboration.py +135 -141
  306. souleyez/storage/timeline_tracker.py +122 -94
  307. souleyez/storage/wazuh_vulns.py +64 -66
  308. souleyez/storage/web_paths.py +33 -37
  309. souleyez/testing/credential_tester.py +221 -205
  310. souleyez/ui/__init__.py +1 -1
  311. souleyez/ui/ai_quotes.py +12 -12
  312. souleyez/ui/attack_surface.py +2439 -1516
  313. souleyez/ui/chain_rules_view.py +914 -382
  314. souleyez/ui/correlation_view.py +312 -230
  315. souleyez/ui/dashboard.py +2382 -1130
  316. souleyez/ui/deliverables_view.py +148 -62
  317. souleyez/ui/design_system.py +13 -13
  318. souleyez/ui/errors.py +49 -49
  319. souleyez/ui/evidence_linking_view.py +284 -179
  320. souleyez/ui/evidence_vault.py +393 -285
  321. souleyez/ui/exploit_suggestions_view.py +555 -349
  322. souleyez/ui/export_view.py +100 -66
  323. souleyez/ui/gap_analysis_view.py +315 -171
  324. souleyez/ui/help_system.py +105 -97
  325. souleyez/ui/intelligence_view.py +436 -293
  326. souleyez/ui/interactive.py +23434 -10286
  327. souleyez/ui/interactive_selector.py +75 -68
  328. souleyez/ui/log_formatter.py +47 -39
  329. souleyez/ui/menu_components.py +22 -13
  330. souleyez/ui/msf_auxiliary_menu.py +184 -133
  331. souleyez/ui/pending_chains_view.py +336 -172
  332. souleyez/ui/progress_indicators.py +5 -3
  333. souleyez/ui/recommendations_view.py +195 -137
  334. souleyez/ui/rule_builder.py +343 -225
  335. souleyez/ui/setup_wizard.py +678 -284
  336. souleyez/ui/shortcuts.py +217 -165
  337. souleyez/ui/splunk_gap_analysis_view.py +452 -270
  338. souleyez/ui/splunk_vulns_view.py +139 -86
  339. souleyez/ui/team_dashboard.py +498 -335
  340. souleyez/ui/template_selector.py +196 -105
  341. souleyez/ui/terminal.py +6 -6
  342. souleyez/ui/timeline_view.py +198 -127
  343. souleyez/ui/tool_setup.py +264 -164
  344. souleyez/ui/tutorial.py +202 -72
  345. souleyez/ui/tutorial_state.py +40 -40
  346. souleyez/ui/wazuh_vulns_view.py +235 -141
  347. souleyez/ui/wordlist_browser.py +260 -107
  348. souleyez/ui.py +464 -312
  349. souleyez/utils/tool_checker.py +427 -367
  350. souleyez/utils.py +33 -29
  351. souleyez/wordlists.py +134 -167
  352. {souleyez-2.43.26.dist-info → souleyez-2.43.34.dist-info}/METADATA +1 -1
  353. souleyez-2.43.34.dist-info/RECORD +443 -0
  354. {souleyez-2.43.26.dist-info → souleyez-2.43.34.dist-info}/WHEEL +1 -1
  355. souleyez-2.43.26.dist-info/RECORD +0 -379
  356. {souleyez-2.43.26.dist-info → souleyez-2.43.34.dist-info}/entry_points.txt +0 -0
  357. {souleyez-2.43.26.dist-info → souleyez-2.43.34.dist-info}/licenses/LICENSE +0 -0
  358. {souleyez-2.43.26.dist-info → souleyez-2.43.34.dist-info}/top_level.txt +0 -0
@@ -43,7 +43,7 @@ class QuoteRotator:
43
43
  else:
44
44
  # Subsequent quotes: clear line and rewrite
45
45
  # \r moves cursor to beginning, then we overwrite with spaces and new content
46
- sys.stdout.write('\r' + ' ' * 120 + '\r') # Clear line
46
+ sys.stdout.write("\r" + " " * 120 + "\r") # Clear line
47
47
  sys.stdout.write(f"{self.prefix}{quote}")
48
48
  sys.stdout.flush()
49
49
 
@@ -51,7 +51,7 @@ class QuoteRotator:
51
51
  self._stop_event.wait(self.interval)
52
52
 
53
53
  # Clear the quote line when done
54
- sys.stdout.write('\r' + ' ' * 120 + '\r')
54
+ sys.stdout.write("\r" + " " * 120 + "\r")
55
55
  sys.stdout.flush()
56
56
 
57
57
  def start(self):
@@ -68,7 +68,9 @@ class QuoteRotator:
68
68
  self._thread.join(timeout=1.0)
69
69
 
70
70
 
71
- def with_quotes(func: Callable, *args, interval: float = 7.0, prefix: str = "🤖 ", **kwargs) -> Any:
71
+ def with_quotes(
72
+ func: Callable, *args, interval: float = 7.0, prefix: str = "🤖 ", **kwargs
73
+ ) -> Any:
72
74
  """
73
75
  Execute a function with rotating quotes in the background.
74
76
 
@@ -1,4 +1,5 @@
1
1
  """Smart recommendations dashboard."""
2
+
2
3
  import click
3
4
  from typing import Dict
4
5
  from souleyez.storage.recommendation_engine import RecommendationEngine
@@ -9,7 +10,7 @@ from souleyez.ui.design_system import DesignSystem
9
10
  def show_recommendations_dashboard(engagement_id: int):
10
11
  """
11
12
  Display AI-powered recommendations dashboard.
12
-
13
+
13
14
  Shows:
14
15
  - Next recommended actions
15
16
  - Blocker resolution suggestions
@@ -20,168 +21,213 @@ def show_recommendations_dashboard(engagement_id: int):
20
21
  """
21
22
  re = RecommendationEngine()
22
23
  em = EngagementManager()
23
-
24
+
24
25
  engagement = em.get_by_id(engagement_id)
25
26
  if not engagement:
26
- click.echo(click.style(" Error: Engagement not found", fg='red'))
27
+ click.echo(click.style(" Error: Engagement not found", fg="red"))
27
28
  click.pause()
28
29
  return
29
-
30
+
30
31
  while True:
31
32
  DesignSystem.clear_screen()
32
-
33
+
33
34
  width = DesignSystem.get_terminal_width()
34
-
35
+
35
36
  # Header
36
37
  click.echo("\n┌" + "─" * (width - 2) + "┐")
37
- click.echo("│" + click.style(" 🤖 SMART RECOMMENDATIONS ".center(width - 2), bold=True, fg='cyan') + "│")
38
+ click.echo(
39
+ "│"
40
+ + click.style(
41
+ " 🤖 SMART RECOMMENDATIONS ".center(width - 2), bold=True, fg="cyan"
42
+ )
43
+ + "│"
44
+ )
38
45
  click.echo("└" + "─" * (width - 2) + "┘")
39
46
  click.echo()
40
-
41
- click.echo(f" Engagement: {click.style(engagement['name'], bold=True, fg='cyan')}")
47
+
48
+ click.echo(
49
+ f" Engagement: {click.style(engagement['name'], bold=True, fg='cyan')}"
50
+ )
42
51
  click.echo()
43
- click.echo(click.style(" Analyzing deliverables, evidence, and progress...", fg='bright_black'))
52
+ click.echo(
53
+ click.style(
54
+ " Analyzing deliverables, evidence, and progress...", fg="bright_black"
55
+ )
56
+ )
44
57
  click.echo()
45
-
58
+
46
59
  # Get recommendations
47
60
  recommendations = re.get_recommendations(engagement_id)
48
-
61
+
49
62
  # Next Actions
50
- next_actions = recommendations['next_actions']
63
+ next_actions = recommendations["next_actions"]
51
64
  if next_actions:
52
- click.echo(click.style(" 🎯 RECOMMENDED NEXT ACTIONS", bold=True, fg='green'))
65
+ click.echo(
66
+ click.style(" 🎯 RECOMMENDED NEXT ACTIONS", bold=True, fg="green")
67
+ )
53
68
  click.echo(" " + "─" * (width - 4))
54
69
  click.echo()
55
-
70
+
56
71
  for idx, rec in enumerate(next_actions[:5], 1):
57
- d = rec['deliverable']
58
- confidence = rec['confidence']
59
-
60
- confidence_color = 'green' if confidence >= 70 else ('yellow' if confidence >= 50 else 'white')
72
+ d = rec["deliverable"]
73
+ confidence = rec["confidence"]
74
+
75
+ confidence_color = (
76
+ "green"
77
+ if confidence >= 70
78
+ else ("yellow" if confidence >= 50 else "white")
79
+ )
61
80
  priority_color = {
62
- 'critical': 'red',
63
- 'high': 'yellow',
64
- 'medium': 'white',
65
- 'low': 'bright_black'
66
- }.get(d.get('priority', 'medium'), 'white')
67
-
68
- click.echo(f" {idx}. [{click.style(f'{confidence}%', fg=confidence_color)}] "
69
- f"[{click.style(d.get('priority', 'medium').upper(), fg=priority_color)}] "
70
- f"{d['title'][:60]}")
71
-
72
- if rec['reasons']:
73
- reasons_str = ', '.join(rec['reasons'][:3])
74
- click.echo(click.style(f" Why: {reasons_str}", fg='bright_black'))
75
-
81
+ "critical": "red",
82
+ "high": "yellow",
83
+ "medium": "white",
84
+ "low": "bright_black",
85
+ }.get(d.get("priority", "medium"), "white")
86
+
87
+ click.echo(
88
+ f" {idx}. [{click.style(f'{confidence}%', fg=confidence_color)}] "
89
+ f"[{click.style(d.get('priority', 'medium').upper(), fg=priority_color)}] "
90
+ f"{d['title'][:60]}"
91
+ )
92
+
93
+ if rec["reasons"]:
94
+ reasons_str = ", ".join(rec["reasons"][:3])
95
+ click.echo(
96
+ click.style(f" Why: {reasons_str}", fg="bright_black")
97
+ )
98
+
76
99
  click.echo()
77
-
100
+
78
101
  # Quick Wins
79
- quick_wins = recommendations['quick_wins']
102
+ quick_wins = recommendations["quick_wins"]
80
103
  if quick_wins:
81
- click.echo(click.style(" ⚡ QUICK WINS", bold=True, fg='cyan'))
104
+ click.echo(click.style(" ⚡ QUICK WINS", bold=True, fg="cyan"))
82
105
  click.echo(" " + "─" * (width - 4))
83
106
  click.echo()
84
-
107
+
85
108
  for idx, qw in enumerate(quick_wins[:3], 1):
86
- d = qw['deliverable']
87
- est_min = qw['estimated_minutes']
88
-
109
+ d = qw["deliverable"]
110
+ est_min = qw["estimated_minutes"]
111
+
89
112
  click.echo(f" {idx}. {d['title'][:60]}")
90
- click.echo(click.style(f" ~{est_min} minutes | {', '.join(qw['reasons'][:2])}", fg='bright_black'))
91
-
113
+ click.echo(
114
+ click.style(
115
+ f" ~{est_min} minutes | {', '.join(qw['reasons'][:2])}",
116
+ fg="bright_black",
117
+ )
118
+ )
119
+
92
120
  click.echo()
93
-
121
+
94
122
  # Coverage Gaps
95
- coverage_gaps = recommendations['coverage_gaps']
123
+ coverage_gaps = recommendations["coverage_gaps"]
96
124
  if coverage_gaps:
97
- click.echo(click.style(" 📊 COVERAGE GAPS", bold=True, fg='yellow'))
125
+ click.echo(click.style(" 📊 COVERAGE GAPS", bold=True, fg="yellow"))
98
126
  click.echo(" " + "─" * (width - 4))
99
127
  click.echo()
100
-
128
+
101
129
  for gap in coverage_gaps[:3]:
102
- severity_color = 'red' if gap['severity'] == 'critical' else 'yellow'
103
- phase_name = gap['phase'].replace('_', ' ').title()
104
-
105
- click.echo(f" • {click.style(phase_name, fg=severity_color)}: "
106
- f"{gap['completion_rate']:.0f}% complete "
107
- f"({gap['remaining']} remaining)")
108
- click.echo(click.style(f"{gap['recommendation']}", fg='bright_black'))
109
-
130
+ severity_color = "red" if gap["severity"] == "critical" else "yellow"
131
+ phase_name = gap["phase"].replace("_", " ").title()
132
+
133
+ click.echo(
134
+ f"{click.style(phase_name, fg=severity_color)}: "
135
+ f"{gap['completion_rate']:.0f}% complete "
136
+ f"({gap['remaining']} remaining)"
137
+ )
138
+ click.echo(
139
+ click.style(f" → {gap['recommendation']}", fg="bright_black")
140
+ )
141
+
110
142
  click.echo()
111
-
143
+
112
144
  # At Risk
113
- at_risk = recommendations['at_risk']
145
+ at_risk = recommendations["at_risk"]
114
146
  if at_risk:
115
- click.echo(click.style(" ⚠️ AT RISK", bold=True, fg='red'))
147
+ click.echo(click.style(" ⚠️ AT RISK", bold=True, fg="red"))
116
148
  click.echo(" " + "─" * (width - 4))
117
149
  click.echo()
118
-
150
+
119
151
  for item in at_risk[:3]:
120
- d = item['deliverable']
152
+ d = item["deliverable"]
121
153
  severity_color = {
122
- 'critical': 'red',
123
- 'high': 'yellow',
124
- 'medium': 'white'
125
- }.get(item['severity'], 'white')
126
-
127
- click.echo(f" • [{click.style(item['severity'].upper(), fg=severity_color)}] "
128
- f"{d['title'][:60]}")
129
-
130
- if item['risk_factors']:
131
- factors_str = ', '.join(item['risk_factors'])
132
- click.echo(click.style(f" Risk: {factors_str}", fg='bright_black'))
133
-
154
+ "critical": "red",
155
+ "high": "yellow",
156
+ "medium": "white",
157
+ }.get(item["severity"], "white")
158
+
159
+ click.echo(
160
+ f" • [{click.style(item['severity'].upper(), fg=severity_color)}] "
161
+ f"{d['title'][:60]}"
162
+ )
163
+
164
+ if item["risk_factors"]:
165
+ factors_str = ", ".join(item["risk_factors"])
166
+ click.echo(
167
+ click.style(f" Risk: {factors_str}", fg="bright_black")
168
+ )
169
+
134
170
  click.echo()
135
-
171
+
136
172
  # Blockers
137
- blockers = recommendations['blockers']
173
+ blockers = recommendations["blockers"]
138
174
  if blockers:
139
- click.echo(click.style(" 🚧 BLOCKER RESOLUTION", bold=True, fg='yellow'))
175
+ click.echo(click.style(" 🚧 BLOCKER RESOLUTION", bold=True, fg="yellow"))
140
176
  click.echo(" " + "─" * (width - 4))
141
177
  click.echo()
142
-
178
+
143
179
  for blocker in blockers[:3]:
144
- d = blocker['deliverable']
145
-
180
+ d = blocker["deliverable"]
181
+
146
182
  click.echo(f" • {d['title'][:60]}")
147
- click.echo(click.style(f" Blocker: {blocker['blocker']}", fg='yellow'))
148
-
149
- if blocker['suggestions']:
150
- click.echo(click.style(f" Suggestions:", fg='bright_black'))
151
- for sugg in blocker['suggestions'][:2]:
152
- click.echo(click.style(f" - {sugg}", fg='bright_black'))
153
-
183
+ click.echo(
184
+ click.style(f" Blocker: {blocker['blocker']}", fg="yellow")
185
+ )
186
+
187
+ if blocker["suggestions"]:
188
+ click.echo(click.style(f" Suggestions:", fg="bright_black"))
189
+ for sugg in blocker["suggestions"][:2]:
190
+ click.echo(click.style(f" - {sugg}", fg="bright_black"))
191
+
154
192
  click.echo()
155
-
193
+
156
194
  # Priority Boost
157
- priority_boost = recommendations['priority_boost']
195
+ priority_boost = recommendations["priority_boost"]
158
196
  if priority_boost:
159
- click.echo(click.style(" 🔼 PRIORITY BOOST SUGGESTIONS", bold=True, fg='cyan'))
197
+ click.echo(
198
+ click.style(" 🔼 PRIORITY BOOST SUGGESTIONS", bold=True, fg="cyan")
199
+ )
160
200
  click.echo(" " + "─" * (width - 4))
161
201
  click.echo()
162
-
202
+
163
203
  for item in priority_boost[:3]:
164
- d = item['deliverable']
165
-
204
+ d = item["deliverable"]
205
+
166
206
  click.echo(f" • {d['title'][:60]}")
167
- click.echo(f" {item['current_priority'].title()} → "
168
- f"{click.style(item['suggested_priority'].title(), bold=True, fg='yellow')}")
169
-
170
- if item['reasons']:
171
- reasons_str = ', '.join(item['reasons'])
172
- click.echo(click.style(f" Why: {reasons_str}", fg='bright_black'))
173
-
207
+ click.echo(
208
+ f" {item['current_priority'].title()} "
209
+ f"{click.style(item['suggested_priority'].title(), bold=True, fg='yellow')}"
210
+ )
211
+
212
+ if item["reasons"]:
213
+ reasons_str = ", ".join(item["reasons"])
214
+ click.echo(
215
+ click.style(f" Why: {reasons_str}", fg="bright_black")
216
+ )
217
+
174
218
  click.echo()
175
-
219
+
176
220
  # Summary message if no recommendations
177
- if not any([next_actions, quick_wins, coverage_gaps, at_risk, blockers, priority_boost]):
178
- click.echo(click.style(" ✅ No recommendations at this time", fg='green'))
221
+ if not any(
222
+ [next_actions, quick_wins, coverage_gaps, at_risk, blockers, priority_boost]
223
+ ):
224
+ click.echo(click.style(" ✅ No recommendations at this time", fg="green"))
179
225
  click.echo()
180
226
  click.echo(" All deliverables are on track!")
181
227
  click.echo()
182
-
228
+
183
229
  # Menu
184
- click.echo(click.style(" ⚙️ ACTIONS", bold=True, fg='cyan'))
230
+ click.echo(click.style(" ⚙️ ACTIONS", bold=True, fg="cyan"))
185
231
  click.echo(" " + "─" * (width - 4))
186
232
  click.echo()
187
233
  click.echo(" [R] Refresh Recommendations")
@@ -189,77 +235,89 @@ def show_recommendations_dashboard(engagement_id: int):
189
235
  click.echo()
190
236
  click.echo(" [q] ← Back")
191
237
  click.echo()
192
-
193
- choice = click.prompt("Select option", type=str, default='q', show_default=False).strip().lower()
194
-
195
- if choice == 'q':
238
+
239
+ choice = (
240
+ click.prompt("Select option", type=str, default="q", show_default=False)
241
+ .strip()
242
+ .lower()
243
+ )
244
+
245
+ if choice == "q":
196
246
  break
197
- elif choice == 'r':
247
+ elif choice == "r":
198
248
  continue
199
- elif choice == 'd':
249
+ elif choice == "d":
200
250
  _show_detailed_analysis(engagement_id, recommendations)
201
251
 
202
252
 
203
253
  def _show_detailed_analysis(engagement_id: int, recommendations: Dict):
204
254
  """Show detailed breakdown of all recommendations."""
205
255
  DesignSystem.clear_screen()
206
-
256
+
207
257
  width = DesignSystem.get_terminal_width()
208
-
258
+
209
259
  click.echo("\n┌" + "─" * (width - 2) + "┐")
210
- click.echo("│" + click.style(" 📊 DETAILED ANALYSIS ".center(width - 2), bold=True, fg='cyan') + "│")
260
+ click.echo(
261
+ "│"
262
+ + click.style(" 📊 DETAILED ANALYSIS ".center(width - 2), bold=True, fg="cyan")
263
+ + "│"
264
+ )
211
265
  click.echo("└" + "─" * (width - 2) + "┘")
212
266
  click.echo()
213
-
267
+
214
268
  # All Next Actions
215
- next_actions = recommendations['next_actions']
269
+ next_actions = recommendations["next_actions"]
216
270
  if next_actions:
217
- click.echo(click.style(" 🎯 ALL RECOMMENDED ACTIONS", bold=True, fg='green'))
271
+ click.echo(click.style(" 🎯 ALL RECOMMENDED ACTIONS", bold=True, fg="green"))
218
272
  click.echo(" " + "─" * (width - 4))
219
273
  click.echo()
220
-
274
+
221
275
  for idx, rec in enumerate(next_actions, 1):
222
- d = rec['deliverable']
223
-
276
+ d = rec["deliverable"]
277
+
224
278
  click.echo(f" {idx}. {d['title']}")
225
279
  click.echo(f" Score: {rec['score']} | Confidence: {rec['confidence']}%")
226
- click.echo(f" Priority: {d.get('priority', 'medium').title()} | "
227
- f"Status: {d['status'].replace('_', ' ').title()}")
228
-
229
- if rec['reasons']:
280
+ click.echo(
281
+ f" Priority: {d.get('priority', 'medium').title()} | "
282
+ f"Status: {d['status'].replace('_', ' ').title()}"
283
+ )
284
+
285
+ if rec["reasons"]:
230
286
  click.echo(f" Reasons: {', '.join(rec['reasons'])}")
231
-
287
+
232
288
  click.echo()
233
-
289
+
234
290
  # All Quick Wins
235
- quick_wins = recommendations['quick_wins']
291
+ quick_wins = recommendations["quick_wins"]
236
292
  if quick_wins:
237
- click.echo(click.style(" ⚡ ALL QUICK WINS", bold=True, fg='cyan'))
293
+ click.echo(click.style(" ⚡ ALL QUICK WINS", bold=True, fg="cyan"))
238
294
  click.echo(" " + "─" * (width - 4))
239
295
  click.echo()
240
-
296
+
241
297
  for idx, qw in enumerate(quick_wins, 1):
242
- d = qw['deliverable']
243
-
298
+ d = qw["deliverable"]
299
+
244
300
  click.echo(f" {idx}. {d['title']}")
245
301
  click.echo(f" Estimated: ~{qw['estimated_minutes']} minutes")
246
302
  click.echo(f" Reasons: {', '.join(qw['reasons'])}")
247
303
  click.echo()
248
-
304
+
249
305
  # All Coverage Gaps
250
- coverage_gaps = recommendations['coverage_gaps']
306
+ coverage_gaps = recommendations["coverage_gaps"]
251
307
  if coverage_gaps:
252
- click.echo(click.style(" 📊 ALL COVERAGE GAPS", bold=True, fg='yellow'))
308
+ click.echo(click.style(" 📊 ALL COVERAGE GAPS", bold=True, fg="yellow"))
253
309
  click.echo(" " + "─" * (width - 4))
254
310
  click.echo()
255
-
311
+
256
312
  for gap in coverage_gaps:
257
- phase_name = gap['phase'].replace('_', ' ').title()
258
-
313
+ phase_name = gap["phase"].replace("_", " ").title()
314
+
259
315
  click.echo(f" • {phase_name}")
260
- click.echo(f" Completion: {gap['completion_rate']:.1f}% "
261
- f"({gap['completed']}/{gap['total']})")
316
+ click.echo(
317
+ f" Completion: {gap['completion_rate']:.1f}% "
318
+ f"({gap['completed']}/{gap['total']})"
319
+ )
262
320
  click.echo(f" Recommendation: {gap['recommendation']}")
263
321
  click.echo()
264
-
322
+
265
323
  click.pause()