empathy-framework 5.3.0__py3-none-any.whl → 5.4.0__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 (458) hide show
  1. empathy_framework-5.4.0.dist-info/METADATA +47 -0
  2. empathy_framework-5.4.0.dist-info/RECORD +8 -0
  3. {empathy_framework-5.3.0.dist-info → empathy_framework-5.4.0.dist-info}/top_level.txt +0 -1
  4. empathy_healthcare_plugin/__init__.py +12 -11
  5. empathy_llm_toolkit/__init__.py +12 -26
  6. empathy_os/__init__.py +12 -356
  7. empathy_software_plugin/__init__.py +12 -11
  8. empathy_framework-5.3.0.dist-info/METADATA +0 -1026
  9. empathy_framework-5.3.0.dist-info/RECORD +0 -456
  10. empathy_framework-5.3.0.dist-info/entry_points.txt +0 -26
  11. empathy_framework-5.3.0.dist-info/licenses/LICENSE +0 -201
  12. empathy_framework-5.3.0.dist-info/licenses/LICENSE_CHANGE_ANNOUNCEMENT.md +0 -101
  13. empathy_healthcare_plugin/monitors/__init__.py +0 -9
  14. empathy_healthcare_plugin/monitors/clinical_protocol_monitor.py +0 -315
  15. empathy_healthcare_plugin/monitors/monitoring/__init__.py +0 -44
  16. empathy_healthcare_plugin/monitors/monitoring/protocol_checker.py +0 -300
  17. empathy_healthcare_plugin/monitors/monitoring/protocol_loader.py +0 -214
  18. empathy_healthcare_plugin/monitors/monitoring/sensor_parsers.py +0 -306
  19. empathy_healthcare_plugin/monitors/monitoring/trajectory_analyzer.py +0 -389
  20. empathy_healthcare_plugin/protocols/cardiac.json +0 -93
  21. empathy_healthcare_plugin/protocols/post_operative.json +0 -92
  22. empathy_healthcare_plugin/protocols/respiratory.json +0 -92
  23. empathy_healthcare_plugin/protocols/sepsis.json +0 -141
  24. empathy_llm_toolkit/README.md +0 -553
  25. empathy_llm_toolkit/agent_factory/__init__.py +0 -53
  26. empathy_llm_toolkit/agent_factory/adapters/__init__.py +0 -85
  27. empathy_llm_toolkit/agent_factory/adapters/autogen_adapter.py +0 -312
  28. empathy_llm_toolkit/agent_factory/adapters/crewai_adapter.py +0 -483
  29. empathy_llm_toolkit/agent_factory/adapters/haystack_adapter.py +0 -298
  30. empathy_llm_toolkit/agent_factory/adapters/langchain_adapter.py +0 -362
  31. empathy_llm_toolkit/agent_factory/adapters/langgraph_adapter.py +0 -333
  32. empathy_llm_toolkit/agent_factory/adapters/native.py +0 -228
  33. empathy_llm_toolkit/agent_factory/adapters/wizard_adapter.py +0 -423
  34. empathy_llm_toolkit/agent_factory/base.py +0 -305
  35. empathy_llm_toolkit/agent_factory/crews/__init__.py +0 -67
  36. empathy_llm_toolkit/agent_factory/crews/code_review.py +0 -1113
  37. empathy_llm_toolkit/agent_factory/crews/health_check.py +0 -1262
  38. empathy_llm_toolkit/agent_factory/crews/refactoring.py +0 -1128
  39. empathy_llm_toolkit/agent_factory/crews/security_audit.py +0 -1018
  40. empathy_llm_toolkit/agent_factory/decorators.py +0 -287
  41. empathy_llm_toolkit/agent_factory/factory.py +0 -558
  42. empathy_llm_toolkit/agent_factory/framework.py +0 -193
  43. empathy_llm_toolkit/agent_factory/memory_integration.py +0 -328
  44. empathy_llm_toolkit/agent_factory/resilient.py +0 -320
  45. empathy_llm_toolkit/agents_md/__init__.py +0 -22
  46. empathy_llm_toolkit/agents_md/loader.py +0 -218
  47. empathy_llm_toolkit/agents_md/parser.py +0 -271
  48. empathy_llm_toolkit/agents_md/registry.py +0 -307
  49. empathy_llm_toolkit/claude_memory.py +0 -466
  50. empathy_llm_toolkit/cli/__init__.py +0 -8
  51. empathy_llm_toolkit/cli/sync_claude.py +0 -487
  52. empathy_llm_toolkit/code_health.py +0 -1313
  53. empathy_llm_toolkit/commands/__init__.py +0 -51
  54. empathy_llm_toolkit/commands/context.py +0 -375
  55. empathy_llm_toolkit/commands/loader.py +0 -301
  56. empathy_llm_toolkit/commands/models.py +0 -231
  57. empathy_llm_toolkit/commands/parser.py +0 -371
  58. empathy_llm_toolkit/commands/registry.py +0 -429
  59. empathy_llm_toolkit/config/__init__.py +0 -29
  60. empathy_llm_toolkit/config/unified.py +0 -291
  61. empathy_llm_toolkit/context/__init__.py +0 -22
  62. empathy_llm_toolkit/context/compaction.py +0 -455
  63. empathy_llm_toolkit/context/manager.py +0 -434
  64. empathy_llm_toolkit/contextual_patterns.py +0 -361
  65. empathy_llm_toolkit/core.py +0 -907
  66. empathy_llm_toolkit/git_pattern_extractor.py +0 -435
  67. empathy_llm_toolkit/hooks/__init__.py +0 -24
  68. empathy_llm_toolkit/hooks/config.py +0 -306
  69. empathy_llm_toolkit/hooks/executor.py +0 -289
  70. empathy_llm_toolkit/hooks/registry.py +0 -302
  71. empathy_llm_toolkit/hooks/scripts/__init__.py +0 -39
  72. empathy_llm_toolkit/hooks/scripts/evaluate_session.py +0 -201
  73. empathy_llm_toolkit/hooks/scripts/first_time_init.py +0 -285
  74. empathy_llm_toolkit/hooks/scripts/pre_compact.py +0 -207
  75. empathy_llm_toolkit/hooks/scripts/session_end.py +0 -183
  76. empathy_llm_toolkit/hooks/scripts/session_start.py +0 -163
  77. empathy_llm_toolkit/hooks/scripts/suggest_compact.py +0 -225
  78. empathy_llm_toolkit/learning/__init__.py +0 -30
  79. empathy_llm_toolkit/learning/evaluator.py +0 -438
  80. empathy_llm_toolkit/learning/extractor.py +0 -514
  81. empathy_llm_toolkit/learning/storage.py +0 -560
  82. empathy_llm_toolkit/levels.py +0 -227
  83. empathy_llm_toolkit/pattern_confidence.py +0 -414
  84. empathy_llm_toolkit/pattern_resolver.py +0 -272
  85. empathy_llm_toolkit/pattern_summary.py +0 -350
  86. empathy_llm_toolkit/providers.py +0 -967
  87. empathy_llm_toolkit/routing/__init__.py +0 -32
  88. empathy_llm_toolkit/routing/model_router.py +0 -362
  89. empathy_llm_toolkit/security/IMPLEMENTATION_SUMMARY.md +0 -413
  90. empathy_llm_toolkit/security/PHASE2_COMPLETE.md +0 -384
  91. empathy_llm_toolkit/security/PHASE2_SECRETS_DETECTOR_COMPLETE.md +0 -271
  92. empathy_llm_toolkit/security/QUICK_REFERENCE.md +0 -316
  93. empathy_llm_toolkit/security/README.md +0 -262
  94. empathy_llm_toolkit/security/__init__.py +0 -62
  95. empathy_llm_toolkit/security/audit_logger.py +0 -929
  96. empathy_llm_toolkit/security/audit_logger_example.py +0 -152
  97. empathy_llm_toolkit/security/pii_scrubber.py +0 -640
  98. empathy_llm_toolkit/security/secrets_detector.py +0 -678
  99. empathy_llm_toolkit/security/secrets_detector_example.py +0 -304
  100. empathy_llm_toolkit/security/secure_memdocs.py +0 -1192
  101. empathy_llm_toolkit/security/secure_memdocs_example.py +0 -278
  102. empathy_llm_toolkit/session_status.py +0 -745
  103. empathy_llm_toolkit/state.py +0 -246
  104. empathy_llm_toolkit/utils/__init__.py +0 -5
  105. empathy_llm_toolkit/utils/tokens.py +0 -349
  106. empathy_os/adaptive/__init__.py +0 -13
  107. empathy_os/adaptive/task_complexity.py +0 -127
  108. empathy_os/agent_monitoring.py +0 -414
  109. empathy_os/cache/__init__.py +0 -117
  110. empathy_os/cache/base.py +0 -166
  111. empathy_os/cache/dependency_manager.py +0 -256
  112. empathy_os/cache/hash_only.py +0 -251
  113. empathy_os/cache/hybrid.py +0 -457
  114. empathy_os/cache/storage.py +0 -285
  115. empathy_os/cache_monitor.py +0 -356
  116. empathy_os/cache_stats.py +0 -298
  117. empathy_os/cli/__init__.py +0 -152
  118. empathy_os/cli/__main__.py +0 -12
  119. empathy_os/cli/commands/__init__.py +0 -1
  120. empathy_os/cli/commands/batch.py +0 -264
  121. empathy_os/cli/commands/cache.py +0 -248
  122. empathy_os/cli/commands/help.py +0 -331
  123. empathy_os/cli/commands/info.py +0 -140
  124. empathy_os/cli/commands/inspect.py +0 -436
  125. empathy_os/cli/commands/inspection.py +0 -57
  126. empathy_os/cli/commands/memory.py +0 -48
  127. empathy_os/cli/commands/metrics.py +0 -92
  128. empathy_os/cli/commands/orchestrate.py +0 -184
  129. empathy_os/cli/commands/patterns.py +0 -207
  130. empathy_os/cli/commands/profiling.py +0 -202
  131. empathy_os/cli/commands/provider.py +0 -98
  132. empathy_os/cli/commands/routing.py +0 -285
  133. empathy_os/cli/commands/setup.py +0 -96
  134. empathy_os/cli/commands/status.py +0 -235
  135. empathy_os/cli/commands/sync.py +0 -166
  136. empathy_os/cli/commands/tier.py +0 -121
  137. empathy_os/cli/commands/utilities.py +0 -114
  138. empathy_os/cli/commands/workflow.py +0 -579
  139. empathy_os/cli/core.py +0 -32
  140. empathy_os/cli/parsers/__init__.py +0 -68
  141. empathy_os/cli/parsers/batch.py +0 -118
  142. empathy_os/cli/parsers/cache.py +0 -65
  143. empathy_os/cli/parsers/help.py +0 -41
  144. empathy_os/cli/parsers/info.py +0 -26
  145. empathy_os/cli/parsers/inspect.py +0 -66
  146. empathy_os/cli/parsers/metrics.py +0 -42
  147. empathy_os/cli/parsers/orchestrate.py +0 -61
  148. empathy_os/cli/parsers/patterns.py +0 -54
  149. empathy_os/cli/parsers/provider.py +0 -40
  150. empathy_os/cli/parsers/routing.py +0 -110
  151. empathy_os/cli/parsers/setup.py +0 -42
  152. empathy_os/cli/parsers/status.py +0 -47
  153. empathy_os/cli/parsers/sync.py +0 -31
  154. empathy_os/cli/parsers/tier.py +0 -33
  155. empathy_os/cli/parsers/workflow.py +0 -77
  156. empathy_os/cli/utils/__init__.py +0 -1
  157. empathy_os/cli/utils/data.py +0 -242
  158. empathy_os/cli/utils/helpers.py +0 -68
  159. empathy_os/cli_legacy.py +0 -3957
  160. empathy_os/cli_minimal.py +0 -1159
  161. empathy_os/cli_router.py +0 -437
  162. empathy_os/cli_unified.py +0 -814
  163. empathy_os/config/__init__.py +0 -66
  164. empathy_os/config/xml_config.py +0 -286
  165. empathy_os/config.py +0 -545
  166. empathy_os/coordination.py +0 -870
  167. empathy_os/core.py +0 -1511
  168. empathy_os/core_modules/__init__.py +0 -15
  169. empathy_os/cost_tracker.py +0 -626
  170. empathy_os/dashboard/__init__.py +0 -41
  171. empathy_os/dashboard/app.py +0 -512
  172. empathy_os/dashboard/simple_server.py +0 -435
  173. empathy_os/dashboard/standalone_server.py +0 -547
  174. empathy_os/discovery.py +0 -306
  175. empathy_os/emergence.py +0 -306
  176. empathy_os/exceptions.py +0 -123
  177. empathy_os/feedback_loops.py +0 -373
  178. empathy_os/hot_reload/README.md +0 -473
  179. empathy_os/hot_reload/__init__.py +0 -62
  180. empathy_os/hot_reload/config.py +0 -83
  181. empathy_os/hot_reload/integration.py +0 -229
  182. empathy_os/hot_reload/reloader.py +0 -298
  183. empathy_os/hot_reload/watcher.py +0 -183
  184. empathy_os/hot_reload/websocket.py +0 -177
  185. empathy_os/levels.py +0 -577
  186. empathy_os/leverage_points.py +0 -441
  187. empathy_os/logging_config.py +0 -261
  188. empathy_os/mcp/__init__.py +0 -10
  189. empathy_os/mcp/server.py +0 -506
  190. empathy_os/memory/__init__.py +0 -237
  191. empathy_os/memory/claude_memory.py +0 -469
  192. empathy_os/memory/config.py +0 -224
  193. empathy_os/memory/control_panel.py +0 -1290
  194. empathy_os/memory/control_panel_support.py +0 -145
  195. empathy_os/memory/cross_session.py +0 -845
  196. empathy_os/memory/edges.py +0 -179
  197. empathy_os/memory/encryption.py +0 -159
  198. empathy_os/memory/file_session.py +0 -770
  199. empathy_os/memory/graph.py +0 -570
  200. empathy_os/memory/long_term.py +0 -913
  201. empathy_os/memory/long_term_types.py +0 -99
  202. empathy_os/memory/mixins/__init__.py +0 -25
  203. empathy_os/memory/mixins/backend_init_mixin.py +0 -249
  204. empathy_os/memory/mixins/capabilities_mixin.py +0 -208
  205. empathy_os/memory/mixins/handoff_mixin.py +0 -208
  206. empathy_os/memory/mixins/lifecycle_mixin.py +0 -49
  207. empathy_os/memory/mixins/long_term_mixin.py +0 -352
  208. empathy_os/memory/mixins/promotion_mixin.py +0 -109
  209. empathy_os/memory/mixins/short_term_mixin.py +0 -182
  210. empathy_os/memory/nodes.py +0 -179
  211. empathy_os/memory/redis_bootstrap.py +0 -540
  212. empathy_os/memory/security/__init__.py +0 -31
  213. empathy_os/memory/security/audit_logger.py +0 -932
  214. empathy_os/memory/security/pii_scrubber.py +0 -640
  215. empathy_os/memory/security/secrets_detector.py +0 -678
  216. empathy_os/memory/short_term.py +0 -2192
  217. empathy_os/memory/simple_storage.py +0 -302
  218. empathy_os/memory/storage/__init__.py +0 -15
  219. empathy_os/memory/storage_backend.py +0 -167
  220. empathy_os/memory/summary_index.py +0 -583
  221. empathy_os/memory/types.py +0 -446
  222. empathy_os/memory/unified.py +0 -182
  223. empathy_os/meta_workflows/__init__.py +0 -74
  224. empathy_os/meta_workflows/agent_creator.py +0 -248
  225. empathy_os/meta_workflows/builtin_templates.py +0 -567
  226. empathy_os/meta_workflows/cli_commands/__init__.py +0 -56
  227. empathy_os/meta_workflows/cli_commands/agent_commands.py +0 -321
  228. empathy_os/meta_workflows/cli_commands/analytics_commands.py +0 -442
  229. empathy_os/meta_workflows/cli_commands/config_commands.py +0 -232
  230. empathy_os/meta_workflows/cli_commands/memory_commands.py +0 -182
  231. empathy_os/meta_workflows/cli_commands/template_commands.py +0 -354
  232. empathy_os/meta_workflows/cli_commands/workflow_commands.py +0 -382
  233. empathy_os/meta_workflows/cli_meta_workflows.py +0 -59
  234. empathy_os/meta_workflows/form_engine.py +0 -292
  235. empathy_os/meta_workflows/intent_detector.py +0 -409
  236. empathy_os/meta_workflows/models.py +0 -569
  237. empathy_os/meta_workflows/pattern_learner.py +0 -738
  238. empathy_os/meta_workflows/plan_generator.py +0 -384
  239. empathy_os/meta_workflows/session_context.py +0 -397
  240. empathy_os/meta_workflows/template_registry.py +0 -229
  241. empathy_os/meta_workflows/workflow.py +0 -984
  242. empathy_os/metrics/__init__.py +0 -12
  243. empathy_os/metrics/collector.py +0 -31
  244. empathy_os/metrics/prompt_metrics.py +0 -194
  245. empathy_os/models/__init__.py +0 -172
  246. empathy_os/models/__main__.py +0 -13
  247. empathy_os/models/adaptive_routing.py +0 -437
  248. empathy_os/models/auth_cli.py +0 -444
  249. empathy_os/models/auth_strategy.py +0 -450
  250. empathy_os/models/cli.py +0 -655
  251. empathy_os/models/empathy_executor.py +0 -354
  252. empathy_os/models/executor.py +0 -257
  253. empathy_os/models/fallback.py +0 -762
  254. empathy_os/models/provider_config.py +0 -282
  255. empathy_os/models/registry.py +0 -472
  256. empathy_os/models/tasks.py +0 -359
  257. empathy_os/models/telemetry/__init__.py +0 -71
  258. empathy_os/models/telemetry/analytics.py +0 -594
  259. empathy_os/models/telemetry/backend.py +0 -196
  260. empathy_os/models/telemetry/data_models.py +0 -431
  261. empathy_os/models/telemetry/storage.py +0 -489
  262. empathy_os/models/token_estimator.py +0 -420
  263. empathy_os/models/validation.py +0 -280
  264. empathy_os/monitoring/__init__.py +0 -52
  265. empathy_os/monitoring/alerts.py +0 -946
  266. empathy_os/monitoring/alerts_cli.py +0 -448
  267. empathy_os/monitoring/multi_backend.py +0 -271
  268. empathy_os/monitoring/otel_backend.py +0 -362
  269. empathy_os/optimization/__init__.py +0 -19
  270. empathy_os/optimization/context_optimizer.py +0 -272
  271. empathy_os/orchestration/__init__.py +0 -67
  272. empathy_os/orchestration/agent_templates.py +0 -707
  273. empathy_os/orchestration/config_store.py +0 -499
  274. empathy_os/orchestration/execution_strategies.py +0 -2111
  275. empathy_os/orchestration/meta_orchestrator.py +0 -1168
  276. empathy_os/orchestration/pattern_learner.py +0 -696
  277. empathy_os/orchestration/real_tools.py +0 -931
  278. empathy_os/pattern_cache.py +0 -187
  279. empathy_os/pattern_library.py +0 -542
  280. empathy_os/patterns/debugging/all_patterns.json +0 -81
  281. empathy_os/patterns/debugging/workflow_20260107_1770825e.json +0 -77
  282. empathy_os/patterns/refactoring_memory.json +0 -89
  283. empathy_os/persistence.py +0 -564
  284. empathy_os/platform_utils.py +0 -265
  285. empathy_os/plugins/__init__.py +0 -28
  286. empathy_os/plugins/base.py +0 -361
  287. empathy_os/plugins/registry.py +0 -268
  288. empathy_os/project_index/__init__.py +0 -32
  289. empathy_os/project_index/cli.py +0 -335
  290. empathy_os/project_index/index.py +0 -667
  291. empathy_os/project_index/models.py +0 -504
  292. empathy_os/project_index/reports.py +0 -474
  293. empathy_os/project_index/scanner.py +0 -777
  294. empathy_os/project_index/scanner_parallel.py +0 -291
  295. empathy_os/prompts/__init__.py +0 -61
  296. empathy_os/prompts/config.py +0 -77
  297. empathy_os/prompts/context.py +0 -177
  298. empathy_os/prompts/parser.py +0 -285
  299. empathy_os/prompts/registry.py +0 -313
  300. empathy_os/prompts/templates.py +0 -208
  301. empathy_os/redis_config.py +0 -302
  302. empathy_os/redis_memory.py +0 -799
  303. empathy_os/resilience/__init__.py +0 -56
  304. empathy_os/resilience/circuit_breaker.py +0 -256
  305. empathy_os/resilience/fallback.py +0 -179
  306. empathy_os/resilience/health.py +0 -300
  307. empathy_os/resilience/retry.py +0 -209
  308. empathy_os/resilience/timeout.py +0 -135
  309. empathy_os/routing/__init__.py +0 -43
  310. empathy_os/routing/chain_executor.py +0 -433
  311. empathy_os/routing/classifier.py +0 -217
  312. empathy_os/routing/smart_router.py +0 -234
  313. empathy_os/routing/workflow_registry.py +0 -343
  314. empathy_os/scaffolding/README.md +0 -589
  315. empathy_os/scaffolding/__init__.py +0 -35
  316. empathy_os/scaffolding/__main__.py +0 -14
  317. empathy_os/scaffolding/cli.py +0 -240
  318. empathy_os/socratic/__init__.py +0 -256
  319. empathy_os/socratic/ab_testing.py +0 -958
  320. empathy_os/socratic/blueprint.py +0 -533
  321. empathy_os/socratic/cli.py +0 -703
  322. empathy_os/socratic/collaboration.py +0 -1114
  323. empathy_os/socratic/domain_templates.py +0 -924
  324. empathy_os/socratic/embeddings.py +0 -738
  325. empathy_os/socratic/engine.py +0 -794
  326. empathy_os/socratic/explainer.py +0 -682
  327. empathy_os/socratic/feedback.py +0 -772
  328. empathy_os/socratic/forms.py +0 -629
  329. empathy_os/socratic/generator.py +0 -732
  330. empathy_os/socratic/llm_analyzer.py +0 -637
  331. empathy_os/socratic/mcp_server.py +0 -702
  332. empathy_os/socratic/session.py +0 -312
  333. empathy_os/socratic/storage.py +0 -667
  334. empathy_os/socratic/success.py +0 -730
  335. empathy_os/socratic/visual_editor.py +0 -860
  336. empathy_os/socratic/web_ui.py +0 -958
  337. empathy_os/telemetry/__init__.py +0 -39
  338. empathy_os/telemetry/agent_coordination.py +0 -475
  339. empathy_os/telemetry/agent_tracking.py +0 -367
  340. empathy_os/telemetry/approval_gates.py +0 -545
  341. empathy_os/telemetry/cli.py +0 -1231
  342. empathy_os/telemetry/commands/__init__.py +0 -14
  343. empathy_os/telemetry/commands/dashboard_commands.py +0 -696
  344. empathy_os/telemetry/event_streaming.py +0 -409
  345. empathy_os/telemetry/feedback_loop.py +0 -567
  346. empathy_os/telemetry/usage_tracker.py +0 -591
  347. empathy_os/templates.py +0 -754
  348. empathy_os/test_generator/__init__.py +0 -38
  349. empathy_os/test_generator/__main__.py +0 -14
  350. empathy_os/test_generator/cli.py +0 -234
  351. empathy_os/test_generator/generator.py +0 -355
  352. empathy_os/test_generator/risk_analyzer.py +0 -216
  353. empathy_os/tier_recommender.py +0 -384
  354. empathy_os/tools.py +0 -183
  355. empathy_os/trust/__init__.py +0 -28
  356. empathy_os/trust/circuit_breaker.py +0 -579
  357. empathy_os/trust_building.py +0 -527
  358. empathy_os/validation/__init__.py +0 -19
  359. empathy_os/validation/xml_validator.py +0 -281
  360. empathy_os/vscode_bridge.py +0 -173
  361. empathy_os/workflow_commands.py +0 -780
  362. empathy_os/workflow_patterns/__init__.py +0 -33
  363. empathy_os/workflow_patterns/behavior.py +0 -249
  364. empathy_os/workflow_patterns/core.py +0 -76
  365. empathy_os/workflow_patterns/output.py +0 -99
  366. empathy_os/workflow_patterns/registry.py +0 -255
  367. empathy_os/workflow_patterns/structural.py +0 -288
  368. empathy_os/workflows/__init__.py +0 -539
  369. empathy_os/workflows/autonomous_test_gen.py +0 -1268
  370. empathy_os/workflows/base.py +0 -2667
  371. empathy_os/workflows/batch_processing.py +0 -342
  372. empathy_os/workflows/bug_predict.py +0 -1084
  373. empathy_os/workflows/builder.py +0 -273
  374. empathy_os/workflows/caching.py +0 -253
  375. empathy_os/workflows/code_review.py +0 -1048
  376. empathy_os/workflows/code_review_adapters.py +0 -312
  377. empathy_os/workflows/code_review_pipeline.py +0 -722
  378. empathy_os/workflows/config.py +0 -645
  379. empathy_os/workflows/dependency_check.py +0 -644
  380. empathy_os/workflows/document_gen/__init__.py +0 -25
  381. empathy_os/workflows/document_gen/config.py +0 -30
  382. empathy_os/workflows/document_gen/report_formatter.py +0 -162
  383. empathy_os/workflows/document_gen/workflow.py +0 -1426
  384. empathy_os/workflows/document_manager.py +0 -216
  385. empathy_os/workflows/document_manager_README.md +0 -134
  386. empathy_os/workflows/documentation_orchestrator.py +0 -1205
  387. empathy_os/workflows/history.py +0 -510
  388. empathy_os/workflows/keyboard_shortcuts/__init__.py +0 -39
  389. empathy_os/workflows/keyboard_shortcuts/generators.py +0 -391
  390. empathy_os/workflows/keyboard_shortcuts/parsers.py +0 -416
  391. empathy_os/workflows/keyboard_shortcuts/prompts.py +0 -295
  392. empathy_os/workflows/keyboard_shortcuts/schema.py +0 -193
  393. empathy_os/workflows/keyboard_shortcuts/workflow.py +0 -509
  394. empathy_os/workflows/llm_base.py +0 -363
  395. empathy_os/workflows/manage_docs.py +0 -87
  396. empathy_os/workflows/manage_docs_README.md +0 -134
  397. empathy_os/workflows/manage_documentation.py +0 -821
  398. empathy_os/workflows/new_sample_workflow1.py +0 -149
  399. empathy_os/workflows/new_sample_workflow1_README.md +0 -150
  400. empathy_os/workflows/orchestrated_health_check.py +0 -849
  401. empathy_os/workflows/orchestrated_release_prep.py +0 -600
  402. empathy_os/workflows/output.py +0 -413
  403. empathy_os/workflows/perf_audit.py +0 -863
  404. empathy_os/workflows/pr_review.py +0 -762
  405. empathy_os/workflows/progress.py +0 -785
  406. empathy_os/workflows/progress_server.py +0 -322
  407. empathy_os/workflows/progressive/README 2.md +0 -454
  408. empathy_os/workflows/progressive/README.md +0 -454
  409. empathy_os/workflows/progressive/__init__.py +0 -82
  410. empathy_os/workflows/progressive/cli.py +0 -219
  411. empathy_os/workflows/progressive/core.py +0 -488
  412. empathy_os/workflows/progressive/orchestrator.py +0 -723
  413. empathy_os/workflows/progressive/reports.py +0 -520
  414. empathy_os/workflows/progressive/telemetry.py +0 -274
  415. empathy_os/workflows/progressive/test_gen.py +0 -495
  416. empathy_os/workflows/progressive/workflow.py +0 -589
  417. empathy_os/workflows/refactor_plan.py +0 -694
  418. empathy_os/workflows/release_prep.py +0 -895
  419. empathy_os/workflows/release_prep_crew.py +0 -969
  420. empathy_os/workflows/research_synthesis.py +0 -404
  421. empathy_os/workflows/routing.py +0 -168
  422. empathy_os/workflows/secure_release.py +0 -593
  423. empathy_os/workflows/security_adapters.py +0 -297
  424. empathy_os/workflows/security_audit.py +0 -1329
  425. empathy_os/workflows/security_audit_phase3.py +0 -355
  426. empathy_os/workflows/seo_optimization.py +0 -633
  427. empathy_os/workflows/step_config.py +0 -234
  428. empathy_os/workflows/telemetry_mixin.py +0 -269
  429. empathy_os/workflows/test5.py +0 -125
  430. empathy_os/workflows/test5_README.md +0 -158
  431. empathy_os/workflows/test_coverage_boost_crew.py +0 -849
  432. empathy_os/workflows/test_gen/__init__.py +0 -52
  433. empathy_os/workflows/test_gen/ast_analyzer.py +0 -249
  434. empathy_os/workflows/test_gen/config.py +0 -88
  435. empathy_os/workflows/test_gen/data_models.py +0 -38
  436. empathy_os/workflows/test_gen/report_formatter.py +0 -289
  437. empathy_os/workflows/test_gen/test_templates.py +0 -381
  438. empathy_os/workflows/test_gen/workflow.py +0 -655
  439. empathy_os/workflows/test_gen.py +0 -54
  440. empathy_os/workflows/test_gen_behavioral.py +0 -477
  441. empathy_os/workflows/test_gen_parallel.py +0 -341
  442. empathy_os/workflows/test_lifecycle.py +0 -526
  443. empathy_os/workflows/test_maintenance.py +0 -627
  444. empathy_os/workflows/test_maintenance_cli.py +0 -590
  445. empathy_os/workflows/test_maintenance_crew.py +0 -840
  446. empathy_os/workflows/test_runner.py +0 -622
  447. empathy_os/workflows/tier_tracking.py +0 -531
  448. empathy_os/workflows/xml_enhanced_crew.py +0 -285
  449. empathy_software_plugin/SOFTWARE_PLUGIN_README.md +0 -57
  450. empathy_software_plugin/cli/__init__.py +0 -120
  451. empathy_software_plugin/cli/inspect.py +0 -362
  452. empathy_software_plugin/cli.py +0 -574
  453. empathy_software_plugin/plugin.py +0 -188
  454. workflow_scaffolding/__init__.py +0 -11
  455. workflow_scaffolding/__main__.py +0 -12
  456. workflow_scaffolding/cli.py +0 -206
  457. workflow_scaffolding/generator.py +0 -265
  458. {empathy_framework-5.3.0.dist-info → empathy_framework-5.4.0.dist-info}/WHEEL +0 -0
@@ -1,849 +0,0 @@
1
- """Orchestrated Health Check Workflow
2
-
3
- Uses meta-orchestration to perform comprehensive project health assessments
4
- with configurable depth levels (daily, weekly, release).
5
-
6
- This workflow demonstrates adaptive agent composition based on execution mode,
7
- intelligent health scoring, and historical trend tracking.
8
-
9
- Architecture:
10
- - MetaOrchestrator selects agents based on mode
11
- - ParallelStrategy for daily/weekly (fast validation)
12
- - RefinementStrategy for release (deep multi-stage analysis)
13
- - Health score calculation with weighted criteria
14
- - Trend tracking for historical comparisons
15
-
16
- Modes:
17
- - daily: Quick parallel check (security, coverage, quality)
18
- - weekly: Comprehensive parallel (+ performance, docs, dependencies)
19
- - release: Deep sequential refinement (multi-stage validation)
20
-
21
- Quality Criteria (weighted):
22
- - Security: 30% (critical issues, vulnerability count)
23
- - Coverage: 25% (test coverage percentage)
24
- - Quality: 20% (code quality score)
25
- - Performance: 15% (bottleneck count, response times)
26
- - Documentation: 10% (completeness percentage)
27
-
28
- Example:
29
- >>> workflow = OrchestratedHealthCheckWorkflow(mode="weekly")
30
- >>> report = await workflow.execute(project_root=".")
31
- >>> print(f"{report.overall_health_score}/100 ({report.grade})")
32
- 85/100 (B)
33
-
34
- Copyright 2025 Smart-AI-Memory
35
- Licensed under Fair Source License 0.9
36
- """
37
-
38
- import asyncio
39
- import json
40
- import logging
41
- from dataclasses import dataclass, field
42
- from datetime import datetime
43
- from pathlib import Path
44
- from typing import Any
45
-
46
- from empathy_os.config import _validate_file_path
47
-
48
- from ..orchestration.agent_templates import AgentTemplate, get_template
49
- from ..orchestration.execution_strategies import ParallelStrategy, StrategyResult
50
- from ..orchestration.meta_orchestrator import MetaOrchestrator
51
-
52
- logger = logging.getLogger(__name__)
53
-
54
-
55
- @dataclass
56
- class CategoryScore:
57
- """Individual category health score.
58
-
59
- Attributes:
60
- name: Category name (e.g., "Security")
61
- score: Score 0-100
62
- weight: Weight in overall score (0-1)
63
- raw_metrics: Raw metrics from agent
64
- issues: Issues found
65
- passed: Whether category passed threshold
66
- """
67
-
68
- name: str
69
- score: float
70
- weight: float
71
- raw_metrics: dict[str, Any] = field(default_factory=dict)
72
- issues: list[str] = field(default_factory=list)
73
- passed: bool = True
74
-
75
-
76
- @dataclass
77
- class HealthCheckReport:
78
- """Comprehensive health check report.
79
-
80
- Attributes:
81
- overall_health_score: Overall health score 0-100
82
- grade: Letter grade (A/B/C/D/F)
83
- category_scores: Scores by category
84
- issues: All issues found
85
- recommendations: Actionable recommendations
86
- trend: Comparison with last check
87
- execution_time: Total execution time in seconds
88
- mode: Execution mode (daily/weekly/release)
89
- timestamp: Report generation time
90
- agents_executed: Number of agents executed
91
- success: Whether check completed successfully
92
- """
93
-
94
- overall_health_score: float
95
- grade: str
96
- category_scores: list[CategoryScore] = field(default_factory=list)
97
- issues: list[str] = field(default_factory=list)
98
- recommendations: list[str] = field(default_factory=list)
99
- trend: str = ""
100
- execution_time: float = 0.0
101
- mode: str = "daily"
102
- timestamp: str = field(default_factory=lambda: datetime.now().isoformat())
103
- agents_executed: int = 0
104
- success: bool = True
105
-
106
- def to_dict(self) -> dict[str, Any]:
107
- """Convert report to dictionary for JSON serialization.
108
-
109
- Returns:
110
- Dictionary representation
111
- """
112
- return {
113
- "overall_health_score": self.overall_health_score,
114
- "grade": self.grade,
115
- "category_scores": [
116
- {
117
- "name": cat.name,
118
- "score": cat.score,
119
- "weight": cat.weight,
120
- "raw_metrics": cat.raw_metrics,
121
- "issues": cat.issues,
122
- "passed": cat.passed,
123
- }
124
- for cat in self.category_scores
125
- ],
126
- "issues": self.issues,
127
- "recommendations": self.recommendations,
128
- "trend": self.trend,
129
- "execution_time": self.execution_time,
130
- "mode": self.mode,
131
- "timestamp": self.timestamp,
132
- "agents_executed": self.agents_executed,
133
- "success": self.success,
134
- }
135
-
136
- def format_console_output(self) -> str:
137
- """Format report for console display.
138
-
139
- Returns:
140
- Human-readable formatted report
141
- """
142
- lines = []
143
-
144
- # Header
145
- lines.append("=" * 70)
146
- lines.append("PROJECT HEALTH CHECK REPORT (Meta-Orchestrated)")
147
- lines.append("=" * 70)
148
- lines.append("")
149
-
150
- # Overall health
151
- grade_emoji = {
152
- "A": "🏆",
153
- "B": "✅",
154
- "C": "⚠️",
155
- "D": "❌",
156
- "F": "🚨",
157
- }
158
- emoji = grade_emoji.get(self.grade, "")
159
-
160
- lines.append(
161
- f"Overall Health: {emoji} {self.overall_health_score:.1f}/100 (Grade {self.grade})"
162
- )
163
- lines.append(f"Mode: {self.mode.upper()}")
164
- lines.append(f"Agents Executed: {self.agents_executed}")
165
- lines.append(f"Generated: {self.timestamp}")
166
- lines.append(f"Duration: {self.execution_time:.2f}s")
167
-
168
- if self.trend:
169
- lines.append(f"Trend: {self.trend}")
170
-
171
- lines.append("")
172
-
173
- # Category scores
174
- lines.append("-" * 70)
175
- lines.append("CATEGORY BREAKDOWN")
176
- lines.append("-" * 70)
177
-
178
- for category in sorted(self.category_scores, key=lambda x: x.score, reverse=True):
179
- status = "✅" if category.passed else "❌"
180
- bar_length = int(category.score / 5) # 0-20 chars
181
- bar = "█" * bar_length
182
- lines.append(
183
- f"{status} {category.name:15} {category.score:5.1f}/100 "
184
- f"(weight: {category.weight * 100:2.0f}%) {bar}"
185
- )
186
-
187
- # Show issues for failing categories
188
- if category.issues and not category.passed:
189
- for issue in category.issues[:3]: # Show first 3
190
- lines.append(f" • {issue}")
191
-
192
- lines.append("")
193
-
194
- # Issues summary
195
- if self.issues:
196
- lines.append("-" * 70)
197
- lines.append(f"🚨 ISSUES FOUND ({len(self.issues)})")
198
- lines.append("-" * 70)
199
- for issue in self.issues[:10]: # Show first 10
200
- lines.append(f" • {issue}")
201
- if len(self.issues) > 10:
202
- lines.append(f" ... and {len(self.issues) - 10} more")
203
- lines.append("")
204
-
205
- # Recommendations
206
- if self.recommendations:
207
- lines.append("-" * 70)
208
- lines.append(f"💡 RECOMMENDATIONS ({len(self.recommendations)})")
209
- lines.append("-" * 70)
210
- for rec in self.recommendations:
211
- lines.append(f" • {rec}")
212
- lines.append("")
213
-
214
- lines.append("=" * 70)
215
-
216
- return "\n".join(lines)
217
-
218
-
219
- class OrchestratedHealthCheckWorkflow:
220
- """Health check workflow using meta-orchestration.
221
-
222
- This workflow performs comprehensive project health assessment using
223
- intelligent agent composition based on execution mode.
224
-
225
- Modes:
226
- - daily: Fast parallel check (security, coverage, quality) with CHEAP/CAPABLE agents
227
- - weekly: Comprehensive parallel (adds performance, docs, deps) with all tiers
228
- - release: Deep sequential refinement with premium agents
229
-
230
- Health Score Calculation:
231
- Weighted average of category scores:
232
- - Security: 30%
233
- - Coverage: 25%
234
- - Quality: 20%
235
- - Performance: 15%
236
- - Documentation: 10%
237
-
238
- Example:
239
- >>> workflow = OrchestratedHealthCheckWorkflow(mode="weekly")
240
- >>> report = await workflow.execute(project_root=".")
241
- >>> if report.overall_health_score >= 80:
242
- ... print("Project is healthy!")
243
- """
244
-
245
- # Category weights for overall score
246
- CATEGORY_WEIGHTS = {
247
- "Security": 0.30,
248
- "Coverage": 0.25,
249
- "Quality": 0.20,
250
- "Performance": 0.15,
251
- "Documentation": 0.10,
252
- }
253
-
254
- # Agent sets by mode
255
- MODE_AGENTS = {
256
- "daily": [
257
- "security_auditor",
258
- "test_coverage_analyzer",
259
- "code_reviewer",
260
- ],
261
- "weekly": [
262
- "security_auditor",
263
- "test_coverage_analyzer",
264
- "code_reviewer",
265
- "performance_optimizer",
266
- "documentation_writer",
267
- ],
268
- "release": [
269
- "security_auditor",
270
- "test_coverage_analyzer",
271
- "code_reviewer",
272
- "performance_optimizer",
273
- "documentation_writer",
274
- "architecture_analyst",
275
- ],
276
- }
277
-
278
- # Grade thresholds
279
- GRADE_THRESHOLDS = {
280
- "A": 90.0,
281
- "B": 80.0,
282
- "C": 70.0,
283
- "D": 60.0,
284
- }
285
-
286
- def __init__(self, mode: str = "daily", project_root: str = ".", **kwargs):
287
- """Initialize health check workflow.
288
-
289
- Args:
290
- mode: Execution mode ("daily", "weekly", "release")
291
- project_root: Project root directory
292
- **kwargs: Extra parameters (ignored, for CLI compatibility)
293
-
294
- Raises:
295
- ValueError: If mode is invalid
296
- """
297
- if mode not in self.MODE_AGENTS:
298
- raise ValueError(
299
- f"Invalid mode: {mode}. Must be one of {list(self.MODE_AGENTS.keys())}"
300
- )
301
-
302
- self.mode = mode
303
- self.project_root = Path(project_root).resolve()
304
- self.orchestrator = MetaOrchestrator()
305
-
306
- # Tracking directory
307
- self.tracking_dir = self.project_root / ".empathy" / "health_tracking"
308
- self.tracking_dir.mkdir(parents=True, exist_ok=True)
309
-
310
- logger.info(
311
- f"OrchestratedHealthCheckWorkflow initialized: mode={mode}, root={project_root}"
312
- )
313
-
314
- async def execute(
315
- self,
316
- project_root: str | None = None,
317
- context: dict[str, Any] | None = None,
318
- **kwargs, # Absorb extra parameters from VSCode/CLI (target, etc.)
319
- ) -> HealthCheckReport:
320
- """Execute health check workflow.
321
-
322
- Args:
323
- project_root: Optional project root (overrides init value)
324
- context: Additional context for agents
325
- **kwargs: Extra parameters (ignored, for VSCode/CLI compatibility)
326
-
327
- Returns:
328
- HealthCheckReport with comprehensive health assessment
329
-
330
- Raises:
331
- ValueError: If project_root is invalid
332
- """
333
- # Map 'target' to 'project_root' for VSCode compatibility
334
- if "target" in kwargs and not project_root:
335
- project_root = kwargs["target"]
336
- if project_root:
337
- self.project_root = Path(project_root).resolve()
338
-
339
- if not self.project_root.exists():
340
- raise ValueError(f"Project root does not exist: {self.project_root}")
341
-
342
- logger.info(f"Starting health check: mode={self.mode}, root={self.project_root}")
343
- start_time = asyncio.get_event_loop().time()
344
-
345
- # Prepare context
346
- full_context = {
347
- "project_root": str(self.project_root),
348
- "mode": self.mode,
349
- **(context or {}),
350
- }
351
-
352
- # Get agents for mode
353
- agent_ids = self.MODE_AGENTS[self.mode]
354
- agents = []
355
- for agent_id in agent_ids:
356
- template = get_template(agent_id)
357
- if template:
358
- agents.append(template)
359
- else:
360
- logger.warning(f"Agent template not found: {agent_id}")
361
-
362
- if not agents:
363
- raise ValueError(f"No agents available for mode: {self.mode}")
364
-
365
- logger.info(f"Selected {len(agents)} agents: {[a.id for a in agents]}")
366
-
367
- # Execute agents based on mode strategy
368
- # All modes use parallel strategy for reliability and speed
369
- # (RefinementStrategy had issues with data passing between stages)
370
- strategy = ParallelStrategy()
371
-
372
- strategy_result = await strategy.execute(agents, full_context)
373
-
374
- # Create health report
375
- report = await self._create_report(strategy_result, agents)
376
-
377
- # Set execution time
378
- end_time = asyncio.get_event_loop().time()
379
- report.execution_time = end_time - start_time
380
-
381
- # Save to tracking history
382
- self._save_tracking_history(report)
383
-
384
- # Save to .empathy/health.json for VS Code extension
385
- self._save_health_json(report)
386
-
387
- logger.info(
388
- f"Health check completed: score={report.overall_health_score:.1f}, "
389
- f"grade={report.grade}, duration={report.execution_time:.2f}s"
390
- )
391
-
392
- return report
393
-
394
- async def _create_report(
395
- self, strategy_result: StrategyResult, agents: list[AgentTemplate]
396
- ) -> HealthCheckReport:
397
- """Create health check report from agent results.
398
-
399
- Args:
400
- strategy_result: Results from strategy execution
401
- agents: Agents that were executed
402
-
403
- Returns:
404
- HealthCheckReport with all findings
405
- """
406
- # Extract agent results
407
- agent_results: dict[str, dict] = {}
408
- for result in strategy_result.outputs:
409
- agent_results[result.agent_id] = {
410
- "success": result.success,
411
- "output": result.output,
412
- "confidence": result.confidence,
413
- "duration": result.duration_seconds,
414
- "error": result.error,
415
- }
416
-
417
- # Calculate category scores
418
- category_scores = self._calculate_category_scores(agent_results)
419
-
420
- # Calculate overall health score
421
- overall_score = self._calculate_overall_score(category_scores)
422
-
423
- # Assign grade
424
- grade = self._assign_grade(overall_score)
425
-
426
- # Collect all issues
427
- issues = []
428
- for category in category_scores:
429
- issues.extend(category.issues)
430
-
431
- # Generate recommendations
432
- recommendations = self._generate_recommendations(category_scores)
433
-
434
- # Get trend comparison
435
- trend = self._get_trend_comparison(overall_score)
436
-
437
- return HealthCheckReport(
438
- overall_health_score=overall_score,
439
- grade=grade,
440
- category_scores=category_scores,
441
- issues=issues,
442
- recommendations=recommendations,
443
- trend=trend,
444
- mode=self.mode,
445
- agents_executed=len(agents),
446
- success=strategy_result.success,
447
- )
448
-
449
- def _calculate_category_scores(self, agent_results: dict[str, dict]) -> list[CategoryScore]:
450
- """Calculate health scores for each category.
451
-
452
- Args:
453
- agent_results: Results from all agents
454
-
455
- Returns:
456
- List of CategoryScore objects
457
- """
458
- scores = []
459
-
460
- # Security score (from security_auditor)
461
- security_result = agent_results.get("security_auditor", {}).get("output", {})
462
- critical_issues = security_result.get("critical_issues", 0)
463
- high_issues = security_result.get("high_issues", 0)
464
- medium_issues = security_result.get("medium_issues", 0)
465
-
466
- security_score = 100.0
467
- security_issues = []
468
-
469
- if critical_issues > 0:
470
- security_score -= critical_issues * 20 # -20 per critical
471
- security_issues.append(f"{critical_issues} critical security issue(s)")
472
- if high_issues > 0:
473
- security_score -= high_issues * 10 # -10 per high
474
- security_issues.append(f"{high_issues} high severity issue(s)")
475
- if medium_issues > 0:
476
- security_score -= medium_issues * 5 # -5 per medium
477
- security_issues.append(f"{medium_issues} medium severity issue(s)")
478
-
479
- security_score = max(0.0, security_score)
480
-
481
- scores.append(
482
- CategoryScore(
483
- name="Security",
484
- score=security_score,
485
- weight=self.CATEGORY_WEIGHTS["Security"],
486
- raw_metrics={
487
- "critical": critical_issues,
488
- "high": high_issues,
489
- "medium": medium_issues,
490
- },
491
- issues=security_issues,
492
- passed=critical_issues == 0 and high_issues == 0,
493
- )
494
- )
495
-
496
- # Coverage score (from test_coverage_analyzer)
497
- coverage_result = agent_results.get("test_coverage_analyzer", {}).get("output", {})
498
- coverage_percent = coverage_result.get("coverage_percent", 0.0)
499
-
500
- coverage_issues = []
501
- if coverage_percent < 80.0:
502
- coverage_issues.append(f"Coverage below 80% ({coverage_percent:.1f}%)")
503
-
504
- scores.append(
505
- CategoryScore(
506
- name="Coverage",
507
- score=coverage_percent,
508
- weight=self.CATEGORY_WEIGHTS["Coverage"],
509
- raw_metrics={"coverage_percent": coverage_percent},
510
- issues=coverage_issues,
511
- passed=coverage_percent >= 80.0,
512
- )
513
- )
514
-
515
- # Quality score (from code_reviewer)
516
- quality_result = agent_results.get("code_reviewer", {}).get("output", {})
517
- quality_score = quality_result.get("quality_score", 0.0)
518
- # Convert 0-10 scale to 0-100
519
- quality_score_100 = quality_score * 10
520
-
521
- quality_issues = []
522
- if quality_score < 7.0:
523
- quality_issues.append(f"Quality score below 7 ({quality_score:.1f}/10)")
524
-
525
- scores.append(
526
- CategoryScore(
527
- name="Quality",
528
- score=quality_score_100,
529
- weight=self.CATEGORY_WEIGHTS["Quality"],
530
- raw_metrics={"quality_score": quality_score},
531
- issues=quality_issues,
532
- passed=quality_score >= 7.0,
533
- )
534
- )
535
-
536
- # Performance score (from performance_optimizer, if available)
537
- if "performance_optimizer" in agent_results:
538
- perf_result = agent_results.get("performance_optimizer", {}).get("output", {})
539
- bottleneck_count = perf_result.get("bottleneck_count", 0)
540
-
541
- perf_score = 100.0 - (bottleneck_count * 10) # -10 per bottleneck
542
- perf_score = max(0.0, perf_score)
543
-
544
- perf_issues = []
545
- if bottleneck_count > 0:
546
- perf_issues.append(f"{bottleneck_count} performance bottleneck(s)")
547
-
548
- scores.append(
549
- CategoryScore(
550
- name="Performance",
551
- score=perf_score,
552
- weight=self.CATEGORY_WEIGHTS["Performance"],
553
- raw_metrics={"bottleneck_count": bottleneck_count},
554
- issues=perf_issues,
555
- passed=bottleneck_count <= 2,
556
- )
557
- )
558
-
559
- # Documentation score (from documentation_writer, if available)
560
- if "documentation_writer" in agent_results:
561
- docs_result = agent_results.get("documentation_writer", {}).get("output", {})
562
- doc_coverage = docs_result.get("coverage_percent", 0.0)
563
-
564
- doc_issues = []
565
- if doc_coverage < 100.0:
566
- doc_issues.append(f"Documentation incomplete ({doc_coverage:.1f}%)")
567
-
568
- scores.append(
569
- CategoryScore(
570
- name="Documentation",
571
- score=doc_coverage,
572
- weight=self.CATEGORY_WEIGHTS["Documentation"],
573
- raw_metrics={"coverage_percent": doc_coverage},
574
- issues=doc_issues,
575
- passed=doc_coverage >= 90.0,
576
- )
577
- )
578
-
579
- return scores
580
-
581
- def _calculate_overall_score(self, category_scores: list[CategoryScore]) -> float:
582
- """Calculate weighted overall health score.
583
-
584
- Args:
585
- category_scores: Category scores
586
-
587
- Returns:
588
- Overall score 0-100
589
- """
590
- total_score = 0.0
591
- total_weight = 0.0
592
-
593
- for category in category_scores:
594
- total_score += category.score * category.weight
595
- total_weight += category.weight
596
-
597
- if total_weight == 0:
598
- return 0.0
599
-
600
- return total_score / total_weight
601
-
602
- def _assign_grade(self, score: float) -> str:
603
- """Assign letter grade based on score.
604
-
605
- Args:
606
- score: Overall health score 0-100
607
-
608
- Returns:
609
- Letter grade (A/B/C/D/F)
610
- """
611
- for grade, threshold in self.GRADE_THRESHOLDS.items():
612
- if score >= threshold:
613
- return grade
614
- return "F"
615
-
616
- def _generate_recommendations(self, category_scores: list[CategoryScore]) -> list[str]:
617
- """Generate actionable recommendations with specific commands.
618
-
619
- Args:
620
- category_scores: Category scores
621
-
622
- Returns:
623
- List of recommendations with commands to run
624
- """
625
- recommendations = []
626
-
627
- # Sort categories by score (lowest first)
628
- sorted_categories = sorted(category_scores, key=lambda x: x.score)
629
-
630
- for category in sorted_categories:
631
- if not category.passed:
632
- if category.name == "Security":
633
- recommendations.append(f"🔒 Address {len(category.issues)} security issue(s)")
634
- recommendations.append(" → Run: empathy workflow run security-audit --path .")
635
- elif category.name == "Coverage":
636
- recommendations.append(
637
- f"🧪 Increase test coverage to 80%+ (currently {category.score:.1f}%)"
638
- )
639
- recommendations.append(" → Run: pytest --cov=src --cov-report=term-missing")
640
- recommendations.append(
641
- " → Or use: empathy workflow run test-gen --path <file>"
642
- )
643
- elif category.name == "Quality":
644
- quality_score = category.raw_metrics.get("quality_score", 0.0)
645
- recommendations.append(
646
- f"✨ Improve code quality to 7+ (currently {quality_score:.1f}/10)"
647
- )
648
- recommendations.append(" → Run: empathy workflow run code-review --path .")
649
- recommendations.append(
650
- " → Or: empathy fix-all (auto-fix lint/format issues)"
651
- )
652
- elif category.name == "Performance":
653
- bottlenecks = category.raw_metrics.get("bottleneck_count", 0)
654
- recommendations.append(f"⚡ Optimize {bottlenecks} performance bottleneck(s)")
655
- recommendations.append(" → Run: empathy workflow run perf-audit --path .")
656
- elif category.name == "Documentation":
657
- recommendations.append(
658
- f"📚 Complete documentation (currently {category.score:.1f}%)"
659
- )
660
- recommendations.append(" → Run: empathy workflow run doc-gen --path .")
661
-
662
- # Add general recommendations
663
- if len(recommendations) == 0:
664
- recommendations.append("✅ Project health looks good! Keep up the good work.")
665
- recommendations.append(
666
- " → Run: empathy orchestrate health-check --mode weekly (for deeper analysis)"
667
- )
668
- elif len(recommendations) >= 6: # Multiple issues
669
- recommendations.append("")
670
- recommendations.append("💡 Tip: Focus on top priority first for maximum impact")
671
- recommendations.append(
672
- " → Rerun: empathy orchestrate health-check --mode daily (to track progress)"
673
- )
674
-
675
- return recommendations
676
-
677
- def _get_trend_comparison(self, current_score: float) -> str:
678
- """Compare current score with last check.
679
-
680
- Args:
681
- current_score: Current health score
682
-
683
- Returns:
684
- Trend description
685
- """
686
- history_file = self.tracking_dir / "history.jsonl"
687
-
688
- if not history_file.exists():
689
- return "No historical data"
690
-
691
- # Read last score from history
692
- try:
693
- with history_file.open("r") as f:
694
- lines = f.readlines()
695
- if len(lines) < 2:
696
- return "First baseline established"
697
-
698
- # Get second-to-last entry (last is current)
699
- previous_entry = json.loads(lines[-2])
700
- previous_score = previous_entry.get("overall_health_score", 0.0)
701
-
702
- delta = current_score - previous_score
703
-
704
- if abs(delta) < 1.0:
705
- return f"Stable (~{previous_score:.1f})"
706
- elif delta > 0:
707
- return f"Improving (+{delta:.1f} from {previous_score:.1f})"
708
- else:
709
- return f"Declining ({delta:.1f} from {previous_score:.1f})"
710
-
711
- except (json.JSONDecodeError, KeyError, IndexError) as e:
712
- logger.warning(f"Error reading tracking history: {e}")
713
- return "Unable to determine trend"
714
-
715
- def _save_tracking_history(self, report: HealthCheckReport) -> None:
716
- """Save health check report to tracking history.
717
-
718
- Args:
719
- report: Health check report to save
720
- """
721
- history_file = self.tracking_dir / "history.jsonl"
722
-
723
- try:
724
- # Append to history file (JSONL format)
725
- with history_file.open("a") as f:
726
- entry = {
727
- "timestamp": report.timestamp,
728
- "mode": report.mode,
729
- "overall_health_score": report.overall_health_score,
730
- "grade": report.grade,
731
- "execution_time": report.execution_time,
732
- "category_scores": [
733
- {"name": cat.name, "score": cat.score} for cat in report.category_scores
734
- ],
735
- }
736
- f.write(json.dumps(entry) + "\n")
737
-
738
- logger.info(f"Saved health check to tracking history: {history_file}")
739
-
740
- except OSError as e:
741
- logger.error(f"Failed to save tracking history: {e}")
742
-
743
- def _save_health_json(self, report: HealthCheckReport) -> None:
744
- """Save health check report to .empathy/health.json for VS Code extension.
745
-
746
- This creates the health.json file that the Empathy VS Code extension
747
- reads to display the interactive health dashboard.
748
-
749
- Args:
750
- report: Health check report to save
751
- """
752
- health_file = self.project_root / ".empathy" / "health.json"
753
-
754
- try:
755
- # Ensure .empathy directory exists
756
- health_file.parent.mkdir(parents=True, exist_ok=True)
757
-
758
- # Extract metrics from category scores
759
- lint_errors = 0
760
- type_errors = 0
761
- security_high = 0
762
- security_medium = 0
763
- security_low = 0
764
- test_passed = 0
765
- test_failed = 0
766
- test_total = 0
767
- coverage_pct = 0.0
768
-
769
- for category in report.category_scores:
770
- if category.name == "Quality":
771
- # Quality issues often come from lint/type errors
772
- quality_score = category.raw_metrics.get("quality_score", 10.0)
773
- # Estimate errors from quality score (10 = perfect, 0 = many errors)
774
- lint_errors = max(0, int((10 - quality_score) * 5))
775
-
776
- elif category.name == "Security":
777
- security_high = category.raw_metrics.get("critical_issues", 0)
778
- security_medium = category.raw_metrics.get("high_issues", 0)
779
- security_low = category.raw_metrics.get("medium_issues", 0)
780
-
781
- elif category.name == "Coverage":
782
- coverage_pct = category.score
783
- # Estimate test counts (assuming good coverage means tests are passing)
784
- if coverage_pct > 70:
785
- test_total = 100
786
- test_passed = int(coverage_pct)
787
- test_failed = test_total - test_passed
788
-
789
- # Build health data in VS Code extension format
790
- health_data = {
791
- "score": int(report.overall_health_score),
792
- "lint": {"errors": lint_errors, "warnings": 0},
793
- "types": {"errors": type_errors},
794
- "security": {
795
- "high": security_high,
796
- "medium": security_medium,
797
- "low": security_low,
798
- },
799
- "tests": {
800
- "passed": test_passed,
801
- "failed": test_failed,
802
- "total": test_total,
803
- "coverage": int(coverage_pct),
804
- },
805
- "tech_debt": {"total": 0, "todos": 0, "fixmes": 0, "hacks": 0},
806
- "timestamp": report.timestamp,
807
- "mode": report.mode,
808
- "grade": report.grade,
809
- }
810
-
811
- # Write health.json
812
- validated_health_file = _validate_file_path(str(health_file))
813
- with validated_health_file.open("w") as f:
814
- json.dump(health_data, f, indent=2)
815
-
816
- logger.info(f"Saved health data to {validated_health_file} for VS Code extension")
817
-
818
- except OSError as e:
819
- logger.warning(f"Failed to save health.json (file system error): {e}")
820
- except (TypeError, ValueError) as e:
821
- logger.error(f"Failed to save health.json (serialization error): {e}")
822
- except Exception as e: # noqa: BLE001
823
- # INTENTIONAL: Saving health data should never crash a health check
824
- logger.warning(f"Failed to save health.json (unexpected error): {e}")
825
-
826
-
827
- async def main():
828
- """CLI entry point for orchestrated health check."""
829
- import sys
830
-
831
- # Parse arguments
832
- mode = sys.argv[1] if len(sys.argv) > 1 else "daily"
833
- project_root = sys.argv[2] if len(sys.argv) > 2 else "."
834
-
835
- # Create workflow
836
- workflow = OrchestratedHealthCheckWorkflow(mode=mode, project_root=project_root)
837
-
838
- # Execute
839
- report = await workflow.execute()
840
-
841
- # Print report
842
- print(report.format_console_output())
843
-
844
- # Exit with appropriate code
845
- sys.exit(0 if report.overall_health_score >= 70 else 1)
846
-
847
-
848
- if __name__ == "__main__":
849
- asyncio.run(main())