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,1026 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: empathy-framework
3
- Version: 5.3.0
4
- Summary: AI collaboration framework with real LLM agent execution, AskUserQuestion tool integration, Socratic agent generation, progressive tier escalation (70-85% cost savings), meta-orchestration, dynamic agent composition (10 patterns including Anthropic-inspired), intelligent caching (85% hit rate), semantic workflow discovery, visual workflow editor, MCP integration for Claude Code, and multi-agent orchestration.
5
- Author-email: Patrick Roebuck <admin@smartaimemory.com>
6
- Maintainer-email: Smart-AI-Memory <admin@smartaimemory.com>
7
- License: Apache License
8
- Version 2.0, January 2004
9
- http://www.apache.org/licenses/
10
-
11
- TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
12
-
13
- 1. Definitions.
14
-
15
- "License" shall mean the terms and conditions for use, reproduction,
16
- and distribution as defined by Sections 1 through 9 of this document.
17
-
18
- "Licensor" shall mean the copyright owner or entity authorized by
19
- the copyright owner that is granting the License.
20
-
21
- "Legal Entity" shall mean the union of the acting entity and all
22
- other entities that control, are controlled by, or are under common
23
- control with that entity. For the purposes of this definition,
24
- "control" means (i) the power, direct or indirect, to cause the
25
- direction or management of such entity, whether by contract or
26
- otherwise, or (ii) ownership of fifty percent (50%) or more of the
27
- outstanding shares, or (iii) beneficial ownership of such entity.
28
-
29
- "You" (or "Your") shall mean an individual or Legal Entity
30
- exercising permissions granted by this License.
31
-
32
- "Source" form shall mean the preferred form for making modifications,
33
- including but not limited to software source code, documentation
34
- source, and configuration files.
35
-
36
- "Object" form shall mean any form resulting from mechanical
37
- transformation or translation of a Source form, including but
38
- not limited to compiled object code, generated documentation,
39
- and conversions to other media types.
40
-
41
- "Work" shall mean the work of authorship, whether in Source or
42
- Object form, made available under the License, as indicated by a
43
- copyright notice that is included in or attached to the work
44
- (an example is provided in the Appendix below).
45
-
46
- "Derivative Works" shall mean any work, whether in Source or Object
47
- form, that is based on (or derived from) the Work and for which the
48
- editorial revisions, annotations, elaborations, or other modifications
49
- represent, as a whole, an original work of authorship. For the purposes
50
- of this License, Derivative Works shall not include works that remain
51
- separable from, or merely link (or bind by name) to the interfaces of,
52
- the Work and Derivative Works thereof.
53
-
54
- "Contribution" shall mean any work of authorship, including
55
- the original version of the Work and any modifications or additions
56
- to that Work or Derivative Works thereof, that is intentionally
57
- submitted to Licensor for inclusion in the Work by the copyright owner
58
- or by an individual or Legal Entity authorized to submit on behalf of
59
- the copyright owner. For the purposes of this definition, "submitted"
60
- means any form of electronic, verbal, or written communication sent
61
- to the Licensor or its representatives, including but not limited to
62
- communication on electronic mailing lists, source code control systems,
63
- and issue tracking systems that are managed by, or on behalf of, the
64
- Licensor for the purpose of discussing and improving the Work, but
65
- excluding communication that is conspicuously marked or otherwise
66
- designated in writing by the copyright owner as "Not a Contribution."
67
-
68
- "Contributor" shall mean Licensor and any individual or Legal Entity
69
- on behalf of whom a Contribution has been received by Licensor and
70
- subsequently incorporated within the Work.
71
-
72
- 2. Grant of Copyright License. Subject to the terms and conditions of
73
- this License, each Contributor hereby grants to You a perpetual,
74
- worldwide, non-exclusive, no-charge, royalty-free, irrevocable
75
- copyright license to reproduce, prepare Derivative Works of,
76
- publicly display, publicly perform, sublicense, and distribute the
77
- Work and such Derivative Works in Source or Object form.
78
-
79
- 3. Grant of Patent License. Subject to the terms and conditions of
80
- this License, each Contributor hereby grants to You a perpetual,
81
- worldwide, non-exclusive, no-charge, royalty-free, irrevocable
82
- (except as stated in this section) patent license to make, have made,
83
- use, offer to sell, sell, import, and otherwise transfer the Work,
84
- where such license applies only to those patent claims licensable
85
- by such Contributor that are necessarily infringed by their
86
- Contribution(s) alone or by combination of their Contribution(s)
87
- with the Work to which such Contribution(s) was submitted. If You
88
- institute patent litigation against any entity (including a
89
- cross-claim or counterclaim in a lawsuit) alleging that the Work
90
- or a Contribution incorporated within the Work constitutes direct
91
- or contributory patent infringement, then any patent licenses
92
- granted to You under this License for that Work shall terminate
93
- as of the date such litigation is filed.
94
-
95
- 4. Redistribution. You may reproduce and distribute copies of the
96
- Work or Derivative Works thereof in any medium, with or without
97
- modifications, and in Source or Object form, provided that You
98
- meet the following conditions:
99
-
100
- (a) You must give any other recipients of the Work or
101
- Derivative Works a copy of this License; and
102
-
103
- (b) You must cause any modified files to carry prominent notices
104
- stating that You changed the files; and
105
-
106
- (c) You must retain, in the Source form of any Derivative Works
107
- that You distribute, all copyright, patent, trademark, and
108
- attribution notices from the Source form of the Work,
109
- excluding those notices that do not pertain to any part of
110
- the Derivative Works; and
111
-
112
- (d) If the Work includes a "NOTICE" text file as part of its
113
- distribution, then any Derivative Works that You distribute must
114
- include a readable copy of the attribution notices contained
115
- within such NOTICE file, excluding those notices that do not
116
- pertain to any part of the Derivative Works, in at least one
117
- of the following places: within a NOTICE text file distributed
118
- as part of the Derivative Works; within the Source form or
119
- documentation, if provided along with the Derivative Works; or,
120
- within a display generated by the Derivative Works, if and
121
- wherever such third-party notices normally appear. The contents
122
- of the NOTICE file are for informational purposes only and
123
- do not modify the License. You may add Your own attribution
124
- notices within Derivative Works that You distribute, alongside
125
- or as an addendum to the NOTICE text from the Work, provided
126
- that such additional attribution notices cannot be construed
127
- as modifying the License.
128
-
129
- You may add Your own copyright statement to Your modifications and
130
- may provide additional or different license terms and conditions
131
- for use, reproduction, or distribution of Your modifications, or
132
- for any such Derivative Works as a whole, provided Your use,
133
- reproduction, and distribution of the Work otherwise complies with
134
- the conditions stated in this License.
135
-
136
- 5. Submission of Contributions. Unless You explicitly state otherwise,
137
- any Contribution intentionally submitted for inclusion in the Work
138
- by You to the Licensor shall be under the terms and conditions of
139
- this License, without any additional terms or conditions.
140
- Notwithstanding the above, nothing herein shall supersede or modify
141
- the terms of any separate license agreement you may have executed
142
- with Licensor regarding such Contributions.
143
-
144
- 6. Trademarks. This License does not grant permission to use the trade
145
- names, trademarks, service marks, or product names of the Licensor,
146
- except as required for reasonable and customary use in describing the
147
- origin of the Work and reproducing the content of the NOTICE file.
148
-
149
- 7. Disclaimer of Warranty. Unless required by applicable law or
150
- agreed to in writing, Licensor provides the Work (and each
151
- Contributor provides its Contributions) on an "AS IS" BASIS,
152
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
153
- implied, including, without limitation, any warranties or conditions
154
- of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
155
- PARTICULAR PURPOSE. You are solely responsible for determining the
156
- appropriateness of using or redistributing the Work and assume any
157
- risks associated with Your exercise of permissions under this License.
158
-
159
- 8. Limitation of Liability. In no event and under no legal theory,
160
- whether in tort (including negligence), contract, or otherwise,
161
- unless required by applicable law (such as deliberate and grossly
162
- negligent acts) or agreed to in writing, shall any Contributor be
163
- liable to You for damages, including any direct, indirect, special,
164
- incidental, or consequential damages of any character arising as a
165
- result of this License or out of the use or inability to use the
166
- Work (including but not limited to damages for loss of goodwill,
167
- work stoppage, computer failure or malfunction, or any and all
168
- other commercial damages or losses), even if such Contributor
169
- has been advised of the possibility of such damages.
170
-
171
- 9. Accepting Warranty or Additional Liability. While redistributing
172
- the Work or Derivative Works thereof, You may choose to offer,
173
- and charge a fee for, acceptance of support, warranty, indemnity,
174
- or other liability obligations and/or rights consistent with this
175
- License. However, in accepting such obligations, You may act only
176
- on Your own behalf and on Your sole responsibility, not on behalf
177
- of any other Contributor, and only if You agree to indemnify,
178
- defend, and hold each Contributor harmless for any liability
179
- incurred by, or claims asserted against, such Contributor by reason
180
- of your accepting any such warranty or additional liability.
181
-
182
- END OF TERMS AND CONDITIONS
183
-
184
- APPENDIX: How to apply the Apache License to your work.
185
-
186
- To apply the Apache License to your work, attach the following
187
- boilerplate notice, with the fields enclosed by brackets "[]"
188
- replaced with your own identifying information. (Don't include
189
- the brackets!) The text should be enclosed in the appropriate
190
- comment syntax for the file format. We also recommend that a
191
- file or class name and description of purpose be included on the
192
- same "printed page" as the copyright notice for easier
193
- identification within third-party archives.
194
-
195
- Copyright 2025 Deep Study AI, LLC
196
-
197
- Licensed under the Apache License, Version 2.0 (the "License");
198
- you may not use this file except in compliance with the License.
199
- You may obtain a copy of the License at
200
-
201
- http://www.apache.org/licenses/LICENSE-2.0
202
-
203
- Unless required by applicable law or agreed to in writing, software
204
- distributed under the License is distributed on an "AS IS" BASIS,
205
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
206
- See the License for the specific language governing permissions and
207
- limitations under the License.
208
-
209
- Project-URL: Homepage, https://www.smartaimemory.com
210
- Project-URL: Documentation, https://www.smartaimemory.com/framework-docs/
211
- Project-URL: Getting Started, https://www.smartaimemory.com/framework-docs/tutorials/quickstart/
212
- Project-URL: FAQ, https://www.smartaimemory.com/framework-docs/reference/FAQ/
213
- Project-URL: Book, https://www.smartaimemory.com/book
214
- Project-URL: Repository, https://github.com/Smart-AI-Memory/empathy-framework
215
- Project-URL: Issues, https://github.com/Smart-AI-Memory/empathy-framework/issues
216
- Project-URL: Discussions, https://github.com/Smart-AI-Memory/empathy-framework/discussions
217
- Project-URL: Changelog, https://github.com/Smart-AI-Memory/empathy-framework/blob/main/CHANGELOG.md
218
- Keywords: ai,collaboration,empathy,anticipatory-ai,systems-thinking,llm,claude,memdocs,level-5-ai,code-inspection,static-analysis,code-quality,sarif,github-actions,developer-tools
219
- Classifier: Development Status :: 5 - Production/Stable
220
- Classifier: Intended Audience :: Developers
221
- Classifier: License :: OSI Approved :: Apache Software License
222
- Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
223
- Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
224
- Classifier: Programming Language :: Python :: 3
225
- Classifier: Programming Language :: Python :: 3.10
226
- Classifier: Programming Language :: Python :: 3.11
227
- Classifier: Programming Language :: Python :: 3.12
228
- Classifier: Programming Language :: Python :: 3.13
229
- Classifier: Operating System :: OS Independent
230
- Requires-Python: >=3.10
231
- Description-Content-Type: text/markdown
232
- License-File: LICENSE
233
- License-File: LICENSE_CHANGE_ANNOUNCEMENT.md
234
- Requires-Dist: pydantic<3.0.0,>=2.0.0
235
- Requires-Dist: typing-extensions<5.0.0,>=4.0.0
236
- Requires-Dist: python-dotenv<2.0.0,>=1.0.0
237
- Requires-Dist: structlog<26.0.0,>=23.0.0
238
- Requires-Dist: defusedxml<1.0.0,>=0.7.0
239
- Requires-Dist: rich<14.0.0,>=13.0.0
240
- Requires-Dist: typer<1.0.0,>=0.9.0
241
- Requires-Dist: pyyaml<7.0,>=6.0
242
- Requires-Dist: anthropic<1.0.0,>=0.25.0
243
- Provides-Extra: anthropic
244
- Requires-Dist: anthropic<1.0.0,>=0.25.0; extra == "anthropic"
245
- Provides-Extra: openai
246
- Requires-Dist: openai<2.0.0,>=1.12.0; extra == "openai"
247
- Provides-Extra: google
248
- Requires-Dist: google-generativeai<1.0.0,>=0.3.0; extra == "google"
249
- Provides-Extra: llm
250
- Requires-Dist: anthropic<1.0.0,>=0.25.0; extra == "llm"
251
- Requires-Dist: openai<2.0.0,>=1.12.0; extra == "llm"
252
- Requires-Dist: google-generativeai<1.0.0,>=0.3.0; extra == "llm"
253
- Provides-Extra: memdocs
254
- Requires-Dist: memdocs>=1.0.0; extra == "memdocs"
255
- Provides-Extra: agents
256
- Requires-Dist: langchain<2.0.0,>=1.0.0; extra == "agents"
257
- Requires-Dist: langchain-core<2.0.0,>=1.2.5; extra == "agents"
258
- Requires-Dist: langchain-text-splitters<0.4.0,>=0.3.9; extra == "agents"
259
- Requires-Dist: langgraph<2.0.0,>=1.0.0; extra == "agents"
260
- Requires-Dist: langgraph-checkpoint<4.0.0,>=3.0.0; extra == "agents"
261
- Requires-Dist: marshmallow<5.0.0,>=4.1.2; extra == "agents"
262
- Provides-Extra: crewai
263
- Requires-Dist: crewai<1.0.0,>=0.1.0; extra == "crewai"
264
- Requires-Dist: langchain<2.0.0,>=0.1.0; extra == "crewai"
265
- Requires-Dist: langchain-core<2.0.0,>=1.2.6; extra == "crewai"
266
- Provides-Extra: cache
267
- Requires-Dist: sentence-transformers<4.0.0,>=2.0.0; extra == "cache"
268
- Requires-Dist: torch<3.0.0,>=2.0.0; extra == "cache"
269
- Requires-Dist: numpy<3.0.0,>=1.24.0; extra == "cache"
270
- Provides-Extra: healthcare
271
- Requires-Dist: anthropic<1.0.0,>=0.25.0; extra == "healthcare"
272
- Requires-Dist: openai<2.0.0,>=1.12.0; extra == "healthcare"
273
- Requires-Dist: google-generativeai<1.0.0,>=0.3.0; extra == "healthcare"
274
- Requires-Dist: memdocs>=1.0.0; extra == "healthcare"
275
- Requires-Dist: langchain<2.0.0,>=1.0.0; extra == "healthcare"
276
- Requires-Dist: langchain-core<2.0.0,>=1.2.5; extra == "healthcare"
277
- Requires-Dist: langchain-text-splitters<0.4.0,>=0.3.9; extra == "healthcare"
278
- Requires-Dist: langgraph<2.0.0,>=1.0.0; extra == "healthcare"
279
- Requires-Dist: langgraph-checkpoint<4.0.0,>=3.0.0; extra == "healthcare"
280
- Requires-Dist: marshmallow<5.0.0,>=4.1.2; extra == "healthcare"
281
- Requires-Dist: python-docx<1.0.0,>=0.8.11; extra == "healthcare"
282
- Requires-Dist: pyyaml<7.0,>=6.0; extra == "healthcare"
283
- Requires-Dist: fastapi<1.0.0,>=0.109.1; extra == "healthcare"
284
- Requires-Dist: uvicorn<1.0.0,>=0.20.0; extra == "healthcare"
285
- Requires-Dist: starlette<1.0.0,>=0.40.0; extra == "healthcare"
286
- Requires-Dist: bcrypt<5.0.0,>=4.0.0; extra == "healthcare"
287
- Requires-Dist: PyJWT[crypto]>=2.8.0; extra == "healthcare"
288
- Requires-Dist: opentelemetry-api<2.0.0,>=1.20.0; extra == "healthcare"
289
- Requires-Dist: opentelemetry-sdk<2.0.0,>=1.20.0; extra == "healthcare"
290
- Requires-Dist: opentelemetry-exporter-otlp-proto-grpc<2.0.0,>=1.20.0; extra == "healthcare"
291
- Requires-Dist: redis<6.0.0,>=5.0.0; extra == "healthcare"
292
- Provides-Extra: software
293
- Requires-Dist: python-docx<1.0.0,>=0.8.11; extra == "software"
294
- Requires-Dist: pyyaml<7.0,>=6.0; extra == "software"
295
- Provides-Extra: backend
296
- Requires-Dist: fastapi<1.0.0,>=0.109.1; extra == "backend"
297
- Requires-Dist: uvicorn<1.0.0,>=0.20.0; extra == "backend"
298
- Requires-Dist: starlette<1.0.0,>=0.40.0; extra == "backend"
299
- Requires-Dist: bcrypt<5.0.0,>=4.0.0; extra == "backend"
300
- Requires-Dist: PyJWT[crypto]>=2.8.0; extra == "backend"
301
- Provides-Extra: lsp
302
- Requires-Dist: pygls<2.0.0,>=1.0.0; extra == "lsp"
303
- Requires-Dist: lsprotocol<2024.0.0,>=2023.0.0; extra == "lsp"
304
- Provides-Extra: windows
305
- Requires-Dist: colorama<1.0.0,>=0.4.6; extra == "windows"
306
- Provides-Extra: otel
307
- Requires-Dist: opentelemetry-api<2.0.0,>=1.20.0; extra == "otel"
308
- Requires-Dist: opentelemetry-sdk<2.0.0,>=1.20.0; extra == "otel"
309
- Requires-Dist: opentelemetry-exporter-otlp-proto-grpc<2.0.0,>=1.20.0; extra == "otel"
310
- Provides-Extra: docs
311
- Requires-Dist: mkdocs<2.0.0,>=1.5.0; extra == "docs"
312
- Requires-Dist: mkdocs-material<10.0.0,>=9.4.0; extra == "docs"
313
- Requires-Dist: mkdocstrings[python]<1.0.0,>=0.24.0; extra == "docs"
314
- Requires-Dist: mkdocs-with-pdf<1.0.0,>=0.9.3; extra == "docs"
315
- Requires-Dist: pymdown-extensions<11.0,>=10.0; extra == "docs"
316
- Provides-Extra: dev
317
- Requires-Dist: pytest<10.0,>=7.0; extra == "dev"
318
- Requires-Dist: pytest-asyncio<2.0,>=0.21; extra == "dev"
319
- Requires-Dist: pytest-cov<8.0,>=4.0; extra == "dev"
320
- Requires-Dist: pytest-mock<4.0,>=3.14.0; extra == "dev"
321
- Requires-Dist: pytest-xdist<4.0,>=3.5.0; extra == "dev"
322
- Requires-Dist: pytest-testmon<3.0,>=2.1.0; extra == "dev"
323
- Requires-Dist: pytest-picked<1.0,>=0.5.0; extra == "dev"
324
- Requires-Dist: black<27.0,>=24.3.0; extra == "dev"
325
- Requires-Dist: mypy<2.0,>=1.0; extra == "dev"
326
- Requires-Dist: ruff<1.0,>=0.1; extra == "dev"
327
- Requires-Dist: coverage<8.0,>=7.0; extra == "dev"
328
- Requires-Dist: bandit<2.0,>=1.7; extra == "dev"
329
- Requires-Dist: pre-commit<5.0,>=3.0; extra == "dev"
330
- Requires-Dist: httpx<1.0.0,>=0.27.0; extra == "dev"
331
- Requires-Dist: fastapi<1.0.0,>=0.109.1; extra == "dev"
332
- Requires-Dist: requests<3.0.0,>=2.28.0; extra == "dev"
333
- Provides-Extra: developer
334
- Requires-Dist: anthropic<1.0.0,>=0.25.0; extra == "developer"
335
- Requires-Dist: openai<2.0.0,>=1.12.0; extra == "developer"
336
- Requires-Dist: google-generativeai<1.0.0,>=0.3.0; extra == "developer"
337
- Requires-Dist: memdocs>=1.0.0; extra == "developer"
338
- Requires-Dist: langchain<2.0.0,>=1.0.0; extra == "developer"
339
- Requires-Dist: langchain-core<2.0.0,>=1.2.5; extra == "developer"
340
- Requires-Dist: langchain-text-splitters<0.4.0,>=0.3.9; extra == "developer"
341
- Requires-Dist: langgraph<2.0.0,>=1.0.0; extra == "developer"
342
- Requires-Dist: langgraph-checkpoint<4.0.0,>=3.0.0; extra == "developer"
343
- Requires-Dist: marshmallow<5.0.0,>=4.1.2; extra == "developer"
344
- Requires-Dist: python-docx<1.0.0,>=0.8.11; extra == "developer"
345
- Requires-Dist: pyyaml<7.0,>=6.0; extra == "developer"
346
- Provides-Extra: enterprise
347
- Requires-Dist: anthropic<1.0.0,>=0.25.0; extra == "enterprise"
348
- Requires-Dist: openai<2.0.0,>=1.12.0; extra == "enterprise"
349
- Requires-Dist: google-generativeai<1.0.0,>=0.3.0; extra == "enterprise"
350
- Requires-Dist: memdocs>=1.0.0; extra == "enterprise"
351
- Requires-Dist: langchain<2.0.0,>=1.0.0; extra == "enterprise"
352
- Requires-Dist: langchain-core<2.0.0,>=1.2.5; extra == "enterprise"
353
- Requires-Dist: langchain-text-splitters<0.4.0,>=0.3.9; extra == "enterprise"
354
- Requires-Dist: langgraph<2.0.0,>=1.0.0; extra == "enterprise"
355
- Requires-Dist: langgraph-checkpoint<4.0.0,>=3.0.0; extra == "enterprise"
356
- Requires-Dist: marshmallow<5.0.0,>=4.1.2; extra == "enterprise"
357
- Requires-Dist: python-docx<1.0.0,>=0.8.11; extra == "enterprise"
358
- Requires-Dist: pyyaml<7.0,>=6.0; extra == "enterprise"
359
- Requires-Dist: fastapi<1.0.0,>=0.109.1; extra == "enterprise"
360
- Requires-Dist: uvicorn<1.0.0,>=0.20.0; extra == "enterprise"
361
- Requires-Dist: starlette<1.0.0,>=0.40.0; extra == "enterprise"
362
- Requires-Dist: bcrypt<5.0.0,>=4.0.0; extra == "enterprise"
363
- Requires-Dist: PyJWT[crypto]>=2.8.0; extra == "enterprise"
364
- Requires-Dist: opentelemetry-api<2.0.0,>=1.20.0; extra == "enterprise"
365
- Requires-Dist: opentelemetry-sdk<2.0.0,>=1.20.0; extra == "enterprise"
366
- Requires-Dist: opentelemetry-exporter-otlp-proto-grpc<2.0.0,>=1.20.0; extra == "enterprise"
367
- Provides-Extra: full
368
- Requires-Dist: anthropic<1.0.0,>=0.25.0; extra == "full"
369
- Requires-Dist: openai<2.0.0,>=1.12.0; extra == "full"
370
- Requires-Dist: google-generativeai<1.0.0,>=0.3.0; extra == "full"
371
- Requires-Dist: memdocs>=1.0.0; extra == "full"
372
- Requires-Dist: langchain<2.0.0,>=1.0.0; extra == "full"
373
- Requires-Dist: langchain-core<2.0.0,>=1.2.5; extra == "full"
374
- Requires-Dist: langchain-text-splitters<0.4.0,>=0.3.9; extra == "full"
375
- Requires-Dist: langgraph<2.0.0,>=1.0.0; extra == "full"
376
- Requires-Dist: langgraph-checkpoint<4.0.0,>=3.0.0; extra == "full"
377
- Requires-Dist: marshmallow<5.0.0,>=4.1.2; extra == "full"
378
- Requires-Dist: python-docx<1.0.0,>=0.8.11; extra == "full"
379
- Requires-Dist: pyyaml<7.0,>=6.0; extra == "full"
380
- Provides-Extra: all
381
- Requires-Dist: anthropic<1.0.0,>=0.25.0; extra == "all"
382
- Requires-Dist: openai<2.0.0,>=1.12.0; extra == "all"
383
- Requires-Dist: google-generativeai<1.0.0,>=0.3.0; extra == "all"
384
- Requires-Dist: memdocs>=1.0.0; extra == "all"
385
- Requires-Dist: langchain<2.0.0,>=1.0.0; extra == "all"
386
- Requires-Dist: langchain-core<2.0.0,>=1.2.5; extra == "all"
387
- Requires-Dist: langchain-text-splitters<0.4.0,>=0.3.9; extra == "all"
388
- Requires-Dist: langgraph<2.0.0,>=1.0.0; extra == "all"
389
- Requires-Dist: langgraph-checkpoint<4.0.0,>=3.0.0; extra == "all"
390
- Requires-Dist: marshmallow<5.0.0,>=4.1.2; extra == "all"
391
- Requires-Dist: python-docx<1.0.0,>=0.8.11; extra == "all"
392
- Requires-Dist: pyyaml<7.0,>=6.0; extra == "all"
393
- Requires-Dist: fastapi<1.0.0,>=0.109.1; extra == "all"
394
- Requires-Dist: uvicorn<1.0.0,>=0.20.0; extra == "all"
395
- Requires-Dist: starlette<1.0.0,>=0.40.0; extra == "all"
396
- Requires-Dist: bcrypt<5.0.0,>=4.0.0; extra == "all"
397
- Requires-Dist: PyJWT[crypto]>=2.8.0; extra == "all"
398
- Requires-Dist: pygls<2.0.0,>=1.0.0; extra == "all"
399
- Requires-Dist: lsprotocol<2024.0.0,>=2023.0.0; extra == "all"
400
- Requires-Dist: colorama<1.0.0,>=0.4.6; extra == "all"
401
- Requires-Dist: opentelemetry-api<2.0.0,>=1.20.0; extra == "all"
402
- Requires-Dist: opentelemetry-sdk<2.0.0,>=1.20.0; extra == "all"
403
- Requires-Dist: opentelemetry-exporter-otlp-proto-grpc<2.0.0,>=1.20.0; extra == "all"
404
- Requires-Dist: mkdocs<2.0.0,>=1.5.0; extra == "all"
405
- Requires-Dist: mkdocs-material<10.0.0,>=9.4.0; extra == "all"
406
- Requires-Dist: mkdocstrings[python]<1.0.0,>=0.24.0; extra == "all"
407
- Requires-Dist: mkdocs-with-pdf<1.0.0,>=0.9.3; extra == "all"
408
- Requires-Dist: pymdown-extensions<11.0,>=10.0; extra == "all"
409
- Requires-Dist: pytest<10.0,>=7.0; extra == "all"
410
- Requires-Dist: pytest-asyncio<2.0,>=0.21; extra == "all"
411
- Requires-Dist: pytest-cov<8.0,>=4.0; extra == "all"
412
- Requires-Dist: black<27.0,>=24.3.0; extra == "all"
413
- Requires-Dist: mypy<2.0,>=1.0; extra == "all"
414
- Requires-Dist: ruff<1.0,>=0.1; extra == "all"
415
- Requires-Dist: coverage<8.0,>=7.0; extra == "all"
416
- Requires-Dist: bandit<2.0,>=1.7; extra == "all"
417
- Requires-Dist: pre-commit<5.0,>=3.0; extra == "all"
418
- Requires-Dist: httpx<1.0.0,>=0.27.0; extra == "all"
419
- Requires-Dist: urllib3<3.0.0,>=2.3.0; extra == "all"
420
- Requires-Dist: aiohttp<4.0.0,>=3.10.0; extra == "all"
421
- Requires-Dist: filelock<4.0.0,>=3.16.0; extra == "all"
422
- Dynamic: license-file
423
-
424
- # Empathy Framework
425
-
426
- **AI-powered developer workflows with cost optimization and pattern learning.**
427
-
428
- Run code review, debugging, testing, and release workflows from your terminal or Claude Code. Smart tier routing saves 34-86% on LLM costs.
429
-
430
- [![PyPI](https://img.shields.io/pypi/v/empathy-framework?color=blue)](https://pypi.org/project/empathy-framework/)
431
- [![Tests](https://img.shields.io/badge/tests-7%2C168%20passing%20(99.9%25)-brightgreen)](https://github.com/Smart-AI-Memory/empathy-framework/actions)
432
- [![Python](https://img.shields.io/badge/python-3.10+-blue)](https://www.python.org)
433
- [![License](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE)
434
- [![Performance](https://img.shields.io/badge/performance-18x%20faster-success)](https://github.com/Smart-AI-Memory/empathy-framework/blob/main/CHANGELOG.md)
435
-
436
- ```bash
437
- pip install empathy-framework[developer]
438
- ```
439
-
440
- ---
441
-
442
- ## 🎯 Transitioning to Claude-Native Architecture
443
-
444
- **Empathy Framework is evolving to focus exclusively on Anthropic/Claude** to unlock features impossible with multi-provider abstraction:
445
-
446
- - **📦 Prompt Caching:** 90% cost reduction on repeated prompts
447
- - **📖 Flexible Context:** 200K via subscription for most tasks, up to 1M via API for large codebases
448
- - **🧠 Extended Thinking:** See Claude's internal reasoning process
449
- - **🔧 Advanced Tool Use:** Optimized for agentic workflows
450
-
451
- **Timeline:**
452
-
453
- - ✅ **v4.8.0 (Jan 2026):** Deprecation warnings for OpenAI/Google/Ollama providers
454
- - ✅ **v5.0.0 (Jan 26, 2026):** Non-Anthropic providers removed (BREAKING - COMPLETE)
455
- - ✅ **v5.0.2 (Jan 28, 2026):** Cost optimization suite with batch processing and caching monitoring
456
-
457
- **Migration Guide:** [docs/CLAUDE_NATIVE.md](docs/CLAUDE_NATIVE.md)
458
-
459
- ---
460
-
461
- ## What's New in v5.3.0
462
-
463
- **🎨 Dashboard Enhancements** - Improved usability and clarity:
464
-
465
- - **Agent Display Names** - Human-readable labels for agents in dashboard (e.g., "Code Analyzer" instead of UUID)
466
- - **Comprehensive Help Panel** - 5-section accordion explaining dashboard features, use cases, and Redis setup
467
- - **UX Improvements** - "Source Agent:" label clarity, "Redis Requires Enabling" status message
468
- - **Browser Cache Busting** - Date-based versioning ensures updates appear immediately
469
-
470
- **📚 Documentation Improvements**:
471
-
472
- - Clarified flexible context strategy (200K subscription + 1M API routing)
473
- - Added Redis requirement documentation for dashboard
474
- - Root directory cleanup (8 archived files)
475
-
476
- **🧪 Test Infrastructure**:
477
-
478
- - Sequential test execution to fix import timing issues
479
- - All agent tracking tests passing (19/19)
480
-
481
- [See Full Changelog](CHANGELOG.md#530---2026-01-31)
482
-
483
- ---
484
-
485
- ## What's New in v5.1.0
486
-
487
- **🤖 Multi-Agent Orchestration** - Full support for custom agents and Anthropic LLM agents:
488
-
489
- - **Agent Coordination Dashboard** - Real-time monitoring with 6 coordination patterns:
490
- - Agent heartbeats and status tracking
491
- - Inter-agent coordination signals
492
- - Event streaming across agent workflows
493
- - Approval gates for human-in-the-loop
494
- - Quality feedback and performance metrics
495
- - Demo mode with test data generation
496
-
497
- - **Custom Agents** - Build specialized agents for your workflow needs
498
- - **LLM Agents from Anthropic** - Leverage Claude's advanced capabilities
499
- - Dashboard accessible at `http://localhost:8000` with `python examples/dashboard_demo.py` **(Requires Redis)**
500
-
501
- **🔐 Authentication Strategy System** - Intelligent routing between Claude subscriptions and Anthropic API:
502
-
503
- ```bash
504
- # Interactive setup
505
- python -m empathy_os.models.auth_cli setup
506
-
507
- # View current configuration
508
- python -m empathy_os.models.auth_cli status
509
-
510
- # Get recommendation for a file
511
- python -m empathy_os.models.auth_cli recommend src/module.py
512
- ```
513
-
514
- **💰 Automatic Cost Optimization** - Workflows choose the best auth method:
515
-
516
- - Small/medium modules (<2000 LOC) → Claude subscription (free)
517
- - Large modules (>2000 LOC) → Anthropic API (pay for what you need)
518
- - 7 workflows integrated: document-gen, test-gen, code-review, bug-predict, security-audit, perf-audit, release-prep
519
- - Auth mode tracking in all workflow outputs for telemetry
520
-
521
- **🧪 Comprehensive Testing** - 7 new integration tests for auth strategy:
522
-
523
- - All workflows tested with auth enabled/disabled
524
- - API and subscription mode verification
525
- - Cost tracking validation
526
-
527
- **📖 Documentation** - 950+ lines across 3 guides:
528
-
529
- - [AUTH_STRATEGY_GUIDE.md](docs/AUTH_STRATEGY_GUIDE.md) - User guide for configuration
530
- - [AUTH_CLI_IMPLEMENTATION.md](docs/AUTH_CLI_IMPLEMENTATION.md) - CLI command reference
531
- - [AUTH_WORKFLOW_INTEGRATIONS.md](docs/AUTH_WORKFLOW_INTEGRATIONS.md) - Integration patterns
532
-
533
- [See Full Changelog](CHANGELOG.md#510---2026-01-29)
534
-
535
- ---
536
-
537
- ## What's New in v5.0.2
538
-
539
- **💰 50% Cost Savings with Batch API** - Process non-urgent tasks asynchronously:
540
-
541
- ```bash
542
- empathy batch submit batch_requests.json # Submit batch job
543
- empathy batch status msgbatch_abc123 # Check progress
544
- empathy batch results msgbatch_abc123 output.json # Download results
545
- ```
546
-
547
- Perfect for: log analysis, report generation, bulk classification, test generation
548
-
549
- **📊 Precise Token Counting** - >98% accurate cost tracking:
550
-
551
- - Integrated Anthropic's `count_tokens()` API for billing-accurate measurements
552
- - 3-tier fallback: API → tiktoken (local) → heuristic
553
- - Cache-aware cost calculation (25% write markup, 90% read discount)
554
-
555
- **📈 Cache Performance Monitoring** - Track your 20-30% caching savings:
556
-
557
- ```bash
558
- empathy cache stats # Show hit rates and cost savings
559
- empathy cache stats --verbose # Detailed token metrics
560
- empathy cache stats --format json # Machine-readable output
561
- ```
562
-
563
- **🧭 Adaptive Routing Analytics** - Intelligent tier recommendations:
564
-
565
- ```bash
566
- empathy routing stats <workflow> # Performance metrics
567
- empathy routing check --all # Tier upgrade recommendations
568
- empathy routing models --provider anthropic # Compare models
569
- ```
570
-
571
- **🔧 Dashboard Fixes** - All 6 agent coordination patterns now operational:
572
- - Agent heartbeats displaying correctly
573
- - Event streaming functional
574
- - Coordination signals working
575
- - Approval gates operational
576
-
577
- [See Full Changelog](CHANGELOG.md#502---2026-01-28) | [Batch API Guide](docs/BATCH_API_GUIDE.md) | [User API Docs](docs/USER_API_DOCUMENTATION.md)
578
-
579
- ---
580
-
581
- ## What's New in v4.9.0
582
-
583
- **⚡ 18x Faster Performance** - Massive performance gains through Phase 2 optimizations:
584
-
585
- - **Redis Two-Tier Caching:** 2x faster memory operations (37,000x for cached keys)
586
- - **Generator Expressions:** 99.9% memory reduction across 27 optimizations
587
- - **Parallel Scanning:** Multi-core processing enabled by default (2-4x faster)
588
- - **Incremental Scanning:** Git diff-based updates (10x faster)
589
-
590
- **🧭 Natural Language Workflows** - Use plain English instead of workflow names:
591
-
592
- ```bash
593
- /workflows "find security vulnerabilities" # → security-audit
594
- /workflows "check code performance" # → perf-audit
595
- /workflows "predict bugs" # → bug-predict
596
- /plan "review my code" # → code-review
597
- ```
598
-
599
- **📊 Real-World Performance:**
600
-
601
- - Combined workflow: 3.59s → 0.2s (**18x faster**)
602
- - Full scan: 3,472 files in 0.98s (was 3.59s)
603
- - Redis cached operations: 37ms → 0.001ms
604
-
605
- **🎯 Improved Navigation:**
606
-
607
- - Split `/workflow` into `/workflows` (automated analysis) and `/plan` (planning/review)
608
- - Clearer hub organization with better categorization
609
- - Natural language routing matches intent to workflow
610
-
611
- [See CHANGELOG.md](CHANGELOG.md) | [Performance Docs](docs/REDIS_OPTIMIZATION_SUMMARY.md)
612
-
613
- ---
614
-
615
- ## What's New in v4.7.0
616
-
617
- **$0 Workflows via Skills** - Multi-agent workflows run through Claude Code's Task tool instead of API calls. No additional cost with your Claude subscription.
618
-
619
- **Socratic Workflows** - Interactive discovery through guided questions. Workflows ask what you need rather than requiring upfront configuration.
620
-
621
- **Security Hardened** - Fixed critical vulnerabilities (path traversal, JWT, SSRF).
622
-
623
- **Hub-Based Commands** - Organized workflows into intuitive command hubs.
624
-
625
- ---
626
-
627
- ## Quick Start
628
-
629
- ### 1. Install
630
-
631
- ```bash
632
- pip install empathy-framework[developer]
633
- ```
634
-
635
- ### 2. Configure
636
-
637
- ```bash
638
- # Auto-detect API keys
639
- python -m empathy_os.models.cli provider
640
-
641
- # Or set explicitly
642
- python -m empathy_os.models.cli provider --set anthropic
643
- ```
644
-
645
- ### 3. Use
646
-
647
- **In Claude Code:**
648
-
649
- ```bash
650
- /dev # Developer tools (debug, commit, PR, review)
651
- /testing # Run tests, coverage, benchmarks
652
- /workflows # Automated analysis (security, bugs, perf)
653
- /plan # Planning, TDD, code review
654
- /docs # Documentation generation
655
- /release # Release preparation
656
-
657
- # Natural language support:
658
- /workflows "find security issues"
659
- /plan "review my code"
660
-
661
- # Direct tool access via MCP (v5.1.1+):
662
- # Claude Code automatically discovers Empathy tools through the MCP server
663
- # Just describe what you need in natural language:
664
- "Run a security audit on src/" → Invokes security_audit tool
665
- "Generate tests for config.py" → Invokes test_generation tool
666
- "Check my auth configuration" → Invokes auth_status tool
667
- "Analyze performance bottlenecks" → Invokes performance_audit tool
668
- ```
669
-
670
- **MCP Server Integration (v5.1.1+):**
671
-
672
- Empathy Framework now includes a Model Context Protocol (MCP) server that exposes all workflows as native Claude Code tools:
673
-
674
- - **10 Tools Available:** security_audit, bug_predict, code_review, test_generation, performance_audit, release_prep, auth_status, auth_recommend, telemetry_stats, dashboard_status
675
- - **Automatic Discovery:** No manual configuration needed - Claude Code finds tools via `.claude/mcp.json`
676
- - **Natural Language Access:** Describe your need and Claude invokes the appropriate tool
677
- - **Verification Hooks:** Automatic validation of Python/JSON files and workflow outputs
678
-
679
- To verify MCP integration:
680
-
681
- ```bash
682
- # Check server is running
683
- echo '{"method":"tools/list","params":{}}' | PYTHONPATH=./src python -m empathy_os.mcp.server
684
-
685
- # Restart Claude Code to load the MCP server
686
- # Tools will appear in Claude's tool list automatically
687
- ```
688
-
689
- See [.claude/MCP_TEST_RESULTS.md](.claude/MCP_TEST_RESULTS.md) for full integration details.
690
-
691
- **CLI:**
692
-
693
- ```bash
694
- empathy workflow run security-audit --path ./src
695
- empathy workflow run test-coverage --target 90
696
- empathy telemetry show # View cost savings
697
- ```
698
-
699
- **Python:**
700
-
701
- ```python
702
- from empathy_os import EmpathyOS
703
-
704
- async with EmpathyOS() as empathy:
705
- result = await empathy.level_2_guided(
706
- "Review this code for security issues"
707
- )
708
- print(result["response"])
709
- ```
710
-
711
- ---
712
-
713
- ## Command Hubs
714
-
715
- Workflows are organized into hubs for easy discovery:
716
-
717
- | Hub | Command | Description |
718
- | ----------------- | ------------- | -------------------------------------------- |
719
- | **Developer** | `/dev` | Debug, commit, PR, code review, quality |
720
- | **Testing** | `/testing` | Run tests, coverage analysis, benchmarks |
721
- | **Documentation** | `/docs` | Generate and manage documentation |
722
- | **Release** | `/release` | Release prep, security scan, publishing |
723
- | **Workflows** | `/workflows` | Automated analysis (security, bugs, perf) |
724
- | **Plan** | `/plan` | Planning, TDD, code review, refactoring |
725
- | **Utilities** | `/utilities` | Project init, dependencies, profiling |
726
- | **Learning** | `/learning` | Pattern learning and session evaluation |
727
- | **Context** | `/context` | State management and memory |
728
- | **Agent** | `/agent` | Create and manage custom agents |
729
-
730
- **Natural Language Support:**
731
-
732
- ```bash
733
- # Use plain English - intelligent routing matches your intent
734
- /workflows "find security vulnerabilities" # → security-audit
735
- /workflows "check code performance" # → perf-audit
736
- /workflows "predict bugs" # → bug-predict
737
- /plan "review my code" # → code-review
738
- /plan "help me plan this feature" # → planning
739
-
740
- # Or use traditional workflow names
741
- /workflows security-audit
742
- /plan code-review
743
- ```
744
-
745
- **Interactive menus:**
746
-
747
- ```bash
748
- /dev # Show interactive menu
749
- /dev "debug auth error" # Jump directly to debugging
750
- /testing "run coverage" # Run coverage analysis
751
- /release # Start release preparation
752
- ```
753
-
754
- ---
755
-
756
- ## Socratic Method
757
-
758
- Workflows guide you through discovery instead of requiring upfront configuration:
759
-
760
- ```text
761
- You: /dev
762
-
763
- Claude: What development task do you need?
764
- 1. Debug issue
765
- 2. Create commit
766
- 3. PR workflow
767
- 4. Quality check
768
-
769
- You: 1
770
-
771
- Claude: What error or unexpected behavior are you seeing?
772
- ```
773
-
774
- **How it works:**
775
-
776
- 1. **Discovery** - Workflow asks targeted questions to understand your needs
777
- 2. **Context gathering** - Collects relevant code, errors, and constraints
778
- 3. **Dynamic agent creation** - Assembles the right team based on your answers
779
- 4. **Execution** - Runs with appropriate tier selection
780
-
781
- **Create custom agents with Socratic guidance:**
782
-
783
- ```bash
784
- /agent create # Guided agent creation
785
- /agent team # Build multi-agent teams interactively
786
- ```
787
-
788
- ---
789
-
790
- ## Cost Optimization
791
-
792
- ### Skills = $0 (Claude Code)
793
-
794
- When using Claude Code, workflows run as skills through the Task tool - **no API costs**:
795
-
796
- ```bash
797
- /dev # $0 - uses your Claude subscription
798
- /testing # $0
799
- /release # $0
800
- /agent create # $0
801
- ```
802
-
803
- ### API Mode (CI/CD, Automation)
804
-
805
- For programmatic use, smart tier routing saves 34-86%:
806
-
807
- | Tier | Model | Use Case | Cost |
808
- | ------- | ------------------- | --------------------------- | ----------- |
809
- | CHEAP | Haiku / GPT-4o-mini | Formatting, simple tasks | ~$0.005 |
810
- | CAPABLE | Sonnet / GPT-4o | Bug fixes, code review | ~$0.08 |
811
- | PREMIUM | Opus / o1 | Architecture, complex design | ~$0.45 |
812
-
813
- ```bash
814
- # Track API usage and savings
815
- empathy telemetry savings --days 30
816
- ```
817
-
818
- ---
819
-
820
- ## Key Features
821
-
822
- ### Multi-Agent Workflows
823
-
824
- ```bash
825
- # 4 parallel agents check release readiness
826
- empathy orchestrate release-prep
827
-
828
- # Sequential coverage improvement
829
- empathy orchestrate test-coverage --target 90
830
- ```
831
-
832
- ### Response Caching
833
-
834
- Up to 57% cache hit rate on similar prompts. Zero config needed.
835
-
836
- ```python
837
- from empathy_os.workflows import SecurityAuditWorkflow
838
-
839
- workflow = SecurityAuditWorkflow(enable_cache=True)
840
- result = await workflow.execute(target_path="./src")
841
- print(f"Cache hit rate: {result.cost_report.cache_hit_rate:.1f}%")
842
- ```
843
-
844
- ### Pattern Learning
845
-
846
- Workflows learn from outcomes and improve over time:
847
-
848
- ```python
849
- from empathy_os.orchestration.config_store import ConfigurationStore
850
-
851
- store = ConfigurationStore()
852
- best = store.get_best_for_task("release_prep")
853
- print(f"Success rate: {best.success_rate:.1%}")
854
- ```
855
-
856
- ### Multi-Provider Support
857
-
858
- ```python
859
- from empathy_llm_toolkit.providers import (
860
- AnthropicProvider, # Claude
861
- OpenAIProvider, # GPT-4
862
- GeminiProvider, # Gemini
863
- LocalProvider, # Ollama, LM Studio
864
- )
865
- ```
866
-
867
- ---
868
-
869
- ## CLI Reference
870
-
871
- ```bash
872
- # Provider configuration
873
- python -m empathy_os.models.cli provider
874
- python -m empathy_os.models.cli provider --set hybrid
875
-
876
- # Workflows
877
- empathy workflow list
878
- empathy workflow run <workflow-name>
879
-
880
- # Cost tracking
881
- empathy telemetry show
882
- empathy telemetry savings --days 30
883
- empathy telemetry export --format csv
884
-
885
- # Orchestration
886
- empathy orchestrate release-prep
887
- empathy orchestrate test-coverage --target 90
888
-
889
- # Meta-workflows
890
- empathy meta-workflow list
891
- empathy meta-workflow run release-prep --real
892
- ```
893
-
894
- ---
895
-
896
- ## Install Options
897
-
898
- ```bash
899
- # Individual developers (recommended)
900
- pip install empathy-framework[developer]
901
-
902
- # All LLM providers
903
- pip install empathy-framework[llm]
904
-
905
- # With caching (semantic similarity)
906
- pip install empathy-framework[cache]
907
-
908
- # Enterprise (auth, rate limiting)
909
- pip install empathy-framework[enterprise]
910
-
911
- # Healthcare (HIPAA compliance)
912
- pip install empathy-framework[healthcare]
913
-
914
- # Development
915
- git clone https://github.com/Smart-AI-Memory/empathy-framework.git
916
- cd empathy-framework && pip install -e .[dev]
917
- ```
918
-
919
- ---
920
-
921
- ## Environment Setup
922
-
923
- ```bash
924
- # At least one provider required
925
- export ANTHROPIC_API_KEY="sk-ant-..."
926
- export OPENAI_API_KEY="sk-..."
927
- export GOOGLE_API_KEY="..."
928
-
929
- # Optional (but required for Agent Dashboard): Redis for memory
930
- export REDIS_URL="redis://localhost:6379"
931
- ```
932
-
933
- ---
934
-
935
- ## VSCode Extension
936
-
937
- Install the Empathy VSCode extension for:
938
-
939
- - **Dashboard** - Health score, costs, patterns
940
- - **One-Click Workflows** - Run from command palette
941
- - **Memory Panel** - Manage Redis and patterns
942
- - **Cost Tracking** - Real-time savings display
943
-
944
- ---
945
-
946
- ## Documentation
947
-
948
- - [Quick Start Guide](docs/quickstart.md)
949
- - [CLI Reference](docs/cli-reference.md)
950
- - [Testing Guide](docs/testing-guide.md)
951
- - [Keyboard Shortcuts](docs/keyboard-shortcuts.md)
952
- - [Full Documentation](https://smartaimemory.com/framework-docs/)
953
-
954
- ---
955
-
956
- ## Security
957
-
958
- - Path traversal protection on all file operations
959
- - JWT authentication with rate limiting
960
- - PII scrubbing in telemetry
961
- - HIPAA/GDPR compliance options
962
- - **Automated security scanning** with 82% accuracy (Phase 3 AST-based detection)
963
-
964
- See [SECURITY.md](SECURITY.md) for vulnerability reporting.
965
-
966
- ### Security Scanning
967
-
968
- **Automated security scanning in CI/CD** - 82% accuracy, blocks critical issues:
969
-
970
- ```bash
971
- # Run security audit locally
972
- empathy workflow run security-audit
973
-
974
- # Scan specific directory
975
- empathy workflow run security-audit --input '{"path":"./src"}'
976
- ```
977
-
978
- **Documentation:**
979
-
980
- - **[Developer Workflow Guide](docs/DEVELOPER_SECURITY_WORKFLOW.md)** - Quick reference for handling security findings (all developers)
981
- - **[CI/CD Integration Guide](docs/CI_SECURITY_SCANNING.md)** - Complete setup and troubleshooting (DevOps, developers)
982
- - **[Scanner Architecture](docs/SECURITY_SCANNER_ARCHITECTURE.md)** - Technical implementation details (engineers, architects)
983
- - **[Remediation Process](docs/SECURITY_REMEDIATION_PROCESS.md)** - 3-phase methodology for improving scanners (security teams, leadership)
984
- - **[API Reference](docs/api-reference/security-scanner.md)** - Complete API documentation (developers extending scanner)
985
-
986
- **Key achievements:**
987
-
988
- - 82.3% reduction in false positives (350 → 62 findings)
989
- - 16x improvement in scanner accuracy
990
- - <15 minute average fix time for critical issues
991
- - Zero critical vulnerabilities in production code
992
-
993
- ---
994
-
995
- ## Contributing
996
-
997
- See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
998
-
999
- ---
1000
-
1001
- ## License
1002
-
1003
- **Apache License 2.0** - Free and open source for everyone. Use it, modify it, build commercial products with it. [Details →](LICENSE)
1004
-
1005
- ---
1006
-
1007
- ## Acknowledgements
1008
-
1009
- This project stands on the shoulders of giants. We are deeply grateful to the open source community and all the amazing projects that make this framework possible.
1010
-
1011
- **[View Full Acknowledgements →](ACKNOWLEDGEMENTS.md)**
1012
-
1013
- Special thanks to:
1014
-
1015
- - **[Anthropic](https://www.anthropic.com/)** - For Claude AI and the Model Context Protocol
1016
- - **[LangChain](https://github.com/langchain-ai/langchain)** - Agent framework powering our meta-orchestration
1017
- - **[FastAPI](https://github.com/tiangolo/fastapi)** - Modern Python web framework
1018
- - **[pytest](https://github.com/pytest-dev/pytest)** - Testing framework making quality assurance effortless
1019
-
1020
- And to all 50+ open source projects we depend on. [See the complete list →](ACKNOWLEDGEMENTS.md)
1021
-
1022
- Want to contribute? See [CONTRIBUTORS.md](CONTRIBUTORS.md)
1023
-
1024
- ---
1025
-
1026
- **Built by [Smart AI Memory](https://smartaimemory.com)** · [Docs](https://smartaimemory.com/framework-docs/) · [Examples](examples/) · [Issues](https://github.com/Smart-AI-Memory/empathy-framework/issues)