empathy-framework 5.2.1__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 (480) 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.2.1.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.2.1.dist-info/METADATA +0 -1002
  9. empathy_framework-5.2.1.dist-info/RECORD +0 -478
  10. empathy_framework-5.2.1.dist-info/entry_points.txt +0 -26
  11. empathy_framework-5.2.1.dist-info/licenses/LICENSE +0 -201
  12. empathy_framework-5.2.1.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 -453
  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 -256
  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 -198
  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 -575
  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 2.py +0 -65
  143. empathy_os/cli/parsers/cache.py +0 -65
  144. empathy_os/cli/parsers/help.py +0 -41
  145. empathy_os/cli/parsers/info.py +0 -26
  146. empathy_os/cli/parsers/inspect.py +0 -66
  147. empathy_os/cli/parsers/metrics.py +0 -42
  148. empathy_os/cli/parsers/orchestrate.py +0 -61
  149. empathy_os/cli/parsers/patterns.py +0 -54
  150. empathy_os/cli/parsers/provider.py +0 -40
  151. empathy_os/cli/parsers/routing.py +0 -110
  152. empathy_os/cli/parsers/setup.py +0 -42
  153. empathy_os/cli/parsers/status.py +0 -47
  154. empathy_os/cli/parsers/sync.py +0 -31
  155. empathy_os/cli/parsers/tier.py +0 -33
  156. empathy_os/cli/parsers/workflow.py +0 -77
  157. empathy_os/cli/utils/__init__.py +0 -1
  158. empathy_os/cli/utils/data.py +0 -242
  159. empathy_os/cli/utils/helpers.py +0 -68
  160. empathy_os/cli_legacy.py +0 -3957
  161. empathy_os/cli_minimal.py +0 -1159
  162. empathy_os/cli_router 2.py +0 -416
  163. empathy_os/cli_router.py +0 -437
  164. empathy_os/cli_unified.py +0 -814
  165. empathy_os/config/__init__.py +0 -66
  166. empathy_os/config/xml_config.py +0 -286
  167. empathy_os/config.py +0 -532
  168. empathy_os/coordination.py +0 -870
  169. empathy_os/core.py +0 -1511
  170. empathy_os/core_modules/__init__.py +0 -15
  171. empathy_os/cost_tracker.py +0 -626
  172. empathy_os/dashboard/__init__.py +0 -41
  173. empathy_os/dashboard/app 2.py +0 -512
  174. empathy_os/dashboard/app.py +0 -512
  175. empathy_os/dashboard/simple_server 2.py +0 -403
  176. empathy_os/dashboard/simple_server.py +0 -403
  177. empathy_os/dashboard/standalone_server 2.py +0 -536
  178. empathy_os/dashboard/standalone_server.py +0 -547
  179. empathy_os/discovery.py +0 -306
  180. empathy_os/emergence.py +0 -306
  181. empathy_os/exceptions.py +0 -123
  182. empathy_os/feedback_loops.py +0 -373
  183. empathy_os/hot_reload/README.md +0 -473
  184. empathy_os/hot_reload/__init__.py +0 -62
  185. empathy_os/hot_reload/config.py +0 -83
  186. empathy_os/hot_reload/integration.py +0 -229
  187. empathy_os/hot_reload/reloader.py +0 -298
  188. empathy_os/hot_reload/watcher.py +0 -183
  189. empathy_os/hot_reload/websocket.py +0 -177
  190. empathy_os/levels.py +0 -577
  191. empathy_os/leverage_points.py +0 -441
  192. empathy_os/logging_config.py +0 -261
  193. empathy_os/mcp/__init__.py +0 -10
  194. empathy_os/mcp/server.py +0 -506
  195. empathy_os/memory/__init__.py +0 -237
  196. empathy_os/memory/claude_memory.py +0 -469
  197. empathy_os/memory/config.py +0 -224
  198. empathy_os/memory/control_panel.py +0 -1290
  199. empathy_os/memory/control_panel_support.py +0 -145
  200. empathy_os/memory/cross_session.py +0 -845
  201. empathy_os/memory/edges.py +0 -179
  202. empathy_os/memory/encryption.py +0 -159
  203. empathy_os/memory/file_session.py +0 -770
  204. empathy_os/memory/graph.py +0 -570
  205. empathy_os/memory/long_term.py +0 -913
  206. empathy_os/memory/long_term_types.py +0 -99
  207. empathy_os/memory/mixins/__init__.py +0 -25
  208. empathy_os/memory/mixins/backend_init_mixin.py +0 -244
  209. empathy_os/memory/mixins/capabilities_mixin.py +0 -199
  210. empathy_os/memory/mixins/handoff_mixin.py +0 -208
  211. empathy_os/memory/mixins/lifecycle_mixin.py +0 -49
  212. empathy_os/memory/mixins/long_term_mixin.py +0 -352
  213. empathy_os/memory/mixins/promotion_mixin.py +0 -109
  214. empathy_os/memory/mixins/short_term_mixin.py +0 -182
  215. empathy_os/memory/nodes.py +0 -179
  216. empathy_os/memory/redis_bootstrap.py +0 -540
  217. empathy_os/memory/security/__init__.py +0 -31
  218. empathy_os/memory/security/audit_logger.py +0 -932
  219. empathy_os/memory/security/pii_scrubber.py +0 -640
  220. empathy_os/memory/security/secrets_detector.py +0 -678
  221. empathy_os/memory/short_term.py +0 -2150
  222. empathy_os/memory/simple_storage.py +0 -302
  223. empathy_os/memory/storage/__init__.py +0 -15
  224. empathy_os/memory/storage_backend.py +0 -167
  225. empathy_os/memory/summary_index.py +0 -583
  226. empathy_os/memory/types.py +0 -441
  227. empathy_os/memory/unified.py +0 -182
  228. empathy_os/meta_workflows/__init__.py +0 -74
  229. empathy_os/meta_workflows/agent_creator.py +0 -248
  230. empathy_os/meta_workflows/builtin_templates.py +0 -567
  231. empathy_os/meta_workflows/cli_commands/__init__.py +0 -56
  232. empathy_os/meta_workflows/cli_commands/agent_commands.py +0 -321
  233. empathy_os/meta_workflows/cli_commands/analytics_commands.py +0 -442
  234. empathy_os/meta_workflows/cli_commands/config_commands.py +0 -232
  235. empathy_os/meta_workflows/cli_commands/memory_commands.py +0 -182
  236. empathy_os/meta_workflows/cli_commands/template_commands.py +0 -354
  237. empathy_os/meta_workflows/cli_commands/workflow_commands.py +0 -382
  238. empathy_os/meta_workflows/cli_meta_workflows.py +0 -59
  239. empathy_os/meta_workflows/form_engine.py +0 -292
  240. empathy_os/meta_workflows/intent_detector.py +0 -409
  241. empathy_os/meta_workflows/models.py +0 -569
  242. empathy_os/meta_workflows/pattern_learner.py +0 -738
  243. empathy_os/meta_workflows/plan_generator.py +0 -384
  244. empathy_os/meta_workflows/session_context.py +0 -397
  245. empathy_os/meta_workflows/template_registry.py +0 -229
  246. empathy_os/meta_workflows/workflow.py +0 -984
  247. empathy_os/metrics/__init__.py +0 -12
  248. empathy_os/metrics/collector.py +0 -31
  249. empathy_os/metrics/prompt_metrics.py +0 -194
  250. empathy_os/models/__init__.py +0 -172
  251. empathy_os/models/__main__.py +0 -13
  252. empathy_os/models/adaptive_routing 2.py +0 -437
  253. empathy_os/models/adaptive_routing.py +0 -437
  254. empathy_os/models/auth_cli.py +0 -444
  255. empathy_os/models/auth_strategy.py +0 -450
  256. empathy_os/models/cli.py +0 -655
  257. empathy_os/models/empathy_executor.py +0 -354
  258. empathy_os/models/executor.py +0 -257
  259. empathy_os/models/fallback.py +0 -762
  260. empathy_os/models/provider_config.py +0 -282
  261. empathy_os/models/registry.py +0 -472
  262. empathy_os/models/tasks.py +0 -359
  263. empathy_os/models/telemetry/__init__.py +0 -71
  264. empathy_os/models/telemetry/analytics.py +0 -594
  265. empathy_os/models/telemetry/backend.py +0 -196
  266. empathy_os/models/telemetry/data_models.py +0 -431
  267. empathy_os/models/telemetry/storage.py +0 -489
  268. empathy_os/models/token_estimator.py +0 -420
  269. empathy_os/models/validation.py +0 -280
  270. empathy_os/monitoring/__init__.py +0 -52
  271. empathy_os/monitoring/alerts.py +0 -946
  272. empathy_os/monitoring/alerts_cli.py +0 -448
  273. empathy_os/monitoring/multi_backend.py +0 -271
  274. empathy_os/monitoring/otel_backend.py +0 -362
  275. empathy_os/optimization/__init__.py +0 -19
  276. empathy_os/optimization/context_optimizer.py +0 -272
  277. empathy_os/orchestration/__init__.py +0 -67
  278. empathy_os/orchestration/agent_templates.py +0 -707
  279. empathy_os/orchestration/config_store.py +0 -499
  280. empathy_os/orchestration/execution_strategies.py +0 -2111
  281. empathy_os/orchestration/meta_orchestrator.py +0 -1168
  282. empathy_os/orchestration/pattern_learner.py +0 -696
  283. empathy_os/orchestration/real_tools.py +0 -931
  284. empathy_os/pattern_cache.py +0 -187
  285. empathy_os/pattern_library.py +0 -542
  286. empathy_os/patterns/debugging/all_patterns.json +0 -81
  287. empathy_os/patterns/debugging/workflow_20260107_1770825e.json +0 -77
  288. empathy_os/patterns/refactoring_memory.json +0 -89
  289. empathy_os/persistence.py +0 -564
  290. empathy_os/platform_utils.py +0 -265
  291. empathy_os/plugins/__init__.py +0 -28
  292. empathy_os/plugins/base.py +0 -361
  293. empathy_os/plugins/registry.py +0 -268
  294. empathy_os/project_index/__init__.py +0 -32
  295. empathy_os/project_index/cli.py +0 -335
  296. empathy_os/project_index/index.py +0 -667
  297. empathy_os/project_index/models.py +0 -504
  298. empathy_os/project_index/reports.py +0 -474
  299. empathy_os/project_index/scanner.py +0 -777
  300. empathy_os/project_index/scanner_parallel 2.py +0 -291
  301. empathy_os/project_index/scanner_parallel.py +0 -291
  302. empathy_os/prompts/__init__.py +0 -61
  303. empathy_os/prompts/config.py +0 -77
  304. empathy_os/prompts/context.py +0 -177
  305. empathy_os/prompts/parser.py +0 -285
  306. empathy_os/prompts/registry.py +0 -313
  307. empathy_os/prompts/templates.py +0 -208
  308. empathy_os/redis_config.py +0 -302
  309. empathy_os/redis_memory.py +0 -799
  310. empathy_os/resilience/__init__.py +0 -56
  311. empathy_os/resilience/circuit_breaker.py +0 -256
  312. empathy_os/resilience/fallback.py +0 -179
  313. empathy_os/resilience/health.py +0 -300
  314. empathy_os/resilience/retry.py +0 -209
  315. empathy_os/resilience/timeout.py +0 -135
  316. empathy_os/routing/__init__.py +0 -43
  317. empathy_os/routing/chain_executor.py +0 -433
  318. empathy_os/routing/classifier.py +0 -217
  319. empathy_os/routing/smart_router.py +0 -234
  320. empathy_os/routing/workflow_registry.py +0 -343
  321. empathy_os/scaffolding/README.md +0 -589
  322. empathy_os/scaffolding/__init__.py +0 -35
  323. empathy_os/scaffolding/__main__.py +0 -14
  324. empathy_os/scaffolding/cli.py +0 -240
  325. empathy_os/socratic/__init__.py +0 -256
  326. empathy_os/socratic/ab_testing.py +0 -958
  327. empathy_os/socratic/blueprint.py +0 -533
  328. empathy_os/socratic/cli.py +0 -703
  329. empathy_os/socratic/collaboration.py +0 -1114
  330. empathy_os/socratic/domain_templates.py +0 -924
  331. empathy_os/socratic/embeddings.py +0 -738
  332. empathy_os/socratic/engine.py +0 -794
  333. empathy_os/socratic/explainer.py +0 -682
  334. empathy_os/socratic/feedback.py +0 -772
  335. empathy_os/socratic/forms.py +0 -629
  336. empathy_os/socratic/generator.py +0 -732
  337. empathy_os/socratic/llm_analyzer.py +0 -637
  338. empathy_os/socratic/mcp_server.py +0 -702
  339. empathy_os/socratic/session.py +0 -312
  340. empathy_os/socratic/storage.py +0 -667
  341. empathy_os/socratic/success.py +0 -730
  342. empathy_os/socratic/visual_editor.py +0 -860
  343. empathy_os/socratic/web_ui.py +0 -958
  344. empathy_os/telemetry/__init__.py +0 -39
  345. empathy_os/telemetry/agent_coordination 2.py +0 -478
  346. empathy_os/telemetry/agent_coordination.py +0 -476
  347. empathy_os/telemetry/agent_tracking 2.py +0 -350
  348. empathy_os/telemetry/agent_tracking.py +0 -348
  349. empathy_os/telemetry/approval_gates 2.py +0 -563
  350. empathy_os/telemetry/approval_gates.py +0 -551
  351. empathy_os/telemetry/cli.py +0 -1231
  352. empathy_os/telemetry/commands/__init__.py +0 -14
  353. empathy_os/telemetry/commands/dashboard_commands.py +0 -696
  354. empathy_os/telemetry/event_streaming 2.py +0 -405
  355. empathy_os/telemetry/event_streaming.py +0 -405
  356. empathy_os/telemetry/feedback_loop 2.py +0 -557
  357. empathy_os/telemetry/feedback_loop.py +0 -554
  358. empathy_os/telemetry/usage_tracker.py +0 -591
  359. empathy_os/templates.py +0 -754
  360. empathy_os/test_generator/__init__.py +0 -38
  361. empathy_os/test_generator/__main__.py +0 -14
  362. empathy_os/test_generator/cli.py +0 -234
  363. empathy_os/test_generator/generator.py +0 -355
  364. empathy_os/test_generator/risk_analyzer.py +0 -216
  365. empathy_os/tier_recommender.py +0 -384
  366. empathy_os/tools.py +0 -183
  367. empathy_os/trust/__init__.py +0 -28
  368. empathy_os/trust/circuit_breaker.py +0 -579
  369. empathy_os/trust_building.py +0 -527
  370. empathy_os/validation/__init__.py +0 -19
  371. empathy_os/validation/xml_validator.py +0 -281
  372. empathy_os/vscode_bridge 2.py +0 -173
  373. empathy_os/vscode_bridge.py +0 -173
  374. empathy_os/workflow_commands.py +0 -780
  375. empathy_os/workflow_patterns/__init__.py +0 -33
  376. empathy_os/workflow_patterns/behavior.py +0 -249
  377. empathy_os/workflow_patterns/core.py +0 -76
  378. empathy_os/workflow_patterns/output.py +0 -99
  379. empathy_os/workflow_patterns/registry.py +0 -255
  380. empathy_os/workflow_patterns/structural.py +0 -288
  381. empathy_os/workflows/__init__.py +0 -539
  382. empathy_os/workflows/autonomous_test_gen.py +0 -1268
  383. empathy_os/workflows/base.py +0 -2667
  384. empathy_os/workflows/batch_processing.py +0 -342
  385. empathy_os/workflows/bug_predict.py +0 -1084
  386. empathy_os/workflows/builder.py +0 -273
  387. empathy_os/workflows/caching.py +0 -253
  388. empathy_os/workflows/code_review.py +0 -1048
  389. empathy_os/workflows/code_review_adapters.py +0 -312
  390. empathy_os/workflows/code_review_pipeline.py +0 -722
  391. empathy_os/workflows/config.py +0 -645
  392. empathy_os/workflows/dependency_check.py +0 -644
  393. empathy_os/workflows/document_gen/__init__.py +0 -25
  394. empathy_os/workflows/document_gen/config.py +0 -30
  395. empathy_os/workflows/document_gen/report_formatter.py +0 -162
  396. empathy_os/workflows/document_gen/workflow.py +0 -1426
  397. empathy_os/workflows/document_gen.py +0 -29
  398. empathy_os/workflows/document_manager.py +0 -216
  399. empathy_os/workflows/document_manager_README.md +0 -134
  400. empathy_os/workflows/documentation_orchestrator.py +0 -1205
  401. empathy_os/workflows/history.py +0 -510
  402. empathy_os/workflows/keyboard_shortcuts/__init__.py +0 -39
  403. empathy_os/workflows/keyboard_shortcuts/generators.py +0 -391
  404. empathy_os/workflows/keyboard_shortcuts/parsers.py +0 -416
  405. empathy_os/workflows/keyboard_shortcuts/prompts.py +0 -295
  406. empathy_os/workflows/keyboard_shortcuts/schema.py +0 -193
  407. empathy_os/workflows/keyboard_shortcuts/workflow.py +0 -509
  408. empathy_os/workflows/llm_base.py +0 -363
  409. empathy_os/workflows/manage_docs.py +0 -87
  410. empathy_os/workflows/manage_docs_README.md +0 -134
  411. empathy_os/workflows/manage_documentation.py +0 -821
  412. empathy_os/workflows/new_sample_workflow1.py +0 -149
  413. empathy_os/workflows/new_sample_workflow1_README.md +0 -150
  414. empathy_os/workflows/orchestrated_health_check.py +0 -849
  415. empathy_os/workflows/orchestrated_release_prep.py +0 -600
  416. empathy_os/workflows/output.py +0 -410
  417. empathy_os/workflows/perf_audit.py +0 -863
  418. empathy_os/workflows/pr_review.py +0 -762
  419. empathy_os/workflows/progress.py +0 -779
  420. empathy_os/workflows/progress_server.py +0 -322
  421. empathy_os/workflows/progressive/README 2.md +0 -454
  422. empathy_os/workflows/progressive/README.md +0 -454
  423. empathy_os/workflows/progressive/__init__ 2.py +0 -92
  424. empathy_os/workflows/progressive/__init__.py +0 -82
  425. empathy_os/workflows/progressive/cli 2.py +0 -242
  426. empathy_os/workflows/progressive/cli.py +0 -219
  427. empathy_os/workflows/progressive/core 2.py +0 -488
  428. empathy_os/workflows/progressive/core.py +0 -488
  429. empathy_os/workflows/progressive/orchestrator 2.py +0 -701
  430. empathy_os/workflows/progressive/orchestrator.py +0 -723
  431. empathy_os/workflows/progressive/reports 2.py +0 -528
  432. empathy_os/workflows/progressive/reports.py +0 -520
  433. empathy_os/workflows/progressive/telemetry 2.py +0 -280
  434. empathy_os/workflows/progressive/telemetry.py +0 -274
  435. empathy_os/workflows/progressive/test_gen 2.py +0 -514
  436. empathy_os/workflows/progressive/test_gen.py +0 -495
  437. empathy_os/workflows/progressive/workflow 2.py +0 -628
  438. empathy_os/workflows/progressive/workflow.py +0 -589
  439. empathy_os/workflows/refactor_plan.py +0 -694
  440. empathy_os/workflows/release_prep.py +0 -895
  441. empathy_os/workflows/release_prep_crew.py +0 -969
  442. empathy_os/workflows/research_synthesis.py +0 -404
  443. empathy_os/workflows/routing.py +0 -168
  444. empathy_os/workflows/secure_release.py +0 -593
  445. empathy_os/workflows/security_adapters.py +0 -297
  446. empathy_os/workflows/security_audit.py +0 -1329
  447. empathy_os/workflows/security_audit_phase3.py +0 -355
  448. empathy_os/workflows/seo_optimization.py +0 -633
  449. empathy_os/workflows/step_config.py +0 -234
  450. empathy_os/workflows/telemetry_mixin.py +0 -269
  451. empathy_os/workflows/test5.py +0 -125
  452. empathy_os/workflows/test5_README.md +0 -158
  453. empathy_os/workflows/test_coverage_boost_crew.py +0 -849
  454. empathy_os/workflows/test_gen/__init__.py +0 -52
  455. empathy_os/workflows/test_gen/ast_analyzer.py +0 -249
  456. empathy_os/workflows/test_gen/config.py +0 -88
  457. empathy_os/workflows/test_gen/data_models.py +0 -38
  458. empathy_os/workflows/test_gen/report_formatter.py +0 -289
  459. empathy_os/workflows/test_gen/test_templates.py +0 -381
  460. empathy_os/workflows/test_gen/workflow.py +0 -655
  461. empathy_os/workflows/test_gen.py +0 -54
  462. empathy_os/workflows/test_gen_behavioral.py +0 -477
  463. empathy_os/workflows/test_gen_parallel.py +0 -341
  464. empathy_os/workflows/test_lifecycle.py +0 -526
  465. empathy_os/workflows/test_maintenance.py +0 -627
  466. empathy_os/workflows/test_maintenance_cli.py +0 -590
  467. empathy_os/workflows/test_maintenance_crew.py +0 -840
  468. empathy_os/workflows/test_runner.py +0 -622
  469. empathy_os/workflows/tier_tracking.py +0 -531
  470. empathy_os/workflows/xml_enhanced_crew.py +0 -285
  471. empathy_software_plugin/SOFTWARE_PLUGIN_README.md +0 -57
  472. empathy_software_plugin/cli/__init__.py +0 -120
  473. empathy_software_plugin/cli/inspect.py +0 -362
  474. empathy_software_plugin/cli.py +0 -574
  475. empathy_software_plugin/plugin.py +0 -188
  476. workflow_scaffolding/__init__.py +0 -11
  477. workflow_scaffolding/__main__.py +0 -12
  478. workflow_scaffolding/cli.py +0 -206
  479. workflow_scaffolding/generator.py +0 -265
  480. {empathy_framework-5.2.1.dist-info → empathy_framework-5.4.0.dist-info}/WHEEL +0 -0
@@ -1,1002 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: empathy-framework
3
- Version: 5.2.1
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
- - **📖 200K Context:** Largest context window available (vs 128K for competitors)
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.1.0
462
-
463
- **🤖 Multi-Agent Orchestration** - Full support for custom agents and Anthropic LLM agents:
464
-
465
- - **Agent Coordination Dashboard** - Real-time monitoring with 6 coordination patterns:
466
- - Agent heartbeats and status tracking
467
- - Inter-agent coordination signals
468
- - Event streaming across agent workflows
469
- - Approval gates for human-in-the-loop
470
- - Quality feedback and performance metrics
471
- - Demo mode with test data generation
472
-
473
- - **Custom Agents** - Build specialized agents for your workflow needs
474
- - **LLM Agents from Anthropic** - Leverage Claude's advanced capabilities
475
- - Dashboard accessible at `http://localhost:8000` with `python examples/dashboard_demo.py`
476
-
477
- **🔐 Authentication Strategy System** - Intelligent routing between Claude subscriptions and Anthropic API:
478
-
479
- ```bash
480
- # Interactive setup
481
- python -m empathy_os.models.auth_cli setup
482
-
483
- # View current configuration
484
- python -m empathy_os.models.auth_cli status
485
-
486
- # Get recommendation for a file
487
- python -m empathy_os.models.auth_cli recommend src/module.py
488
- ```
489
-
490
- **💰 Automatic Cost Optimization** - Workflows choose the best auth method:
491
-
492
- - Small/medium modules (<2000 LOC) → Claude subscription (free)
493
- - Large modules (>2000 LOC) → Anthropic API (pay for what you need)
494
- - 7 workflows integrated: document-gen, test-gen, code-review, bug-predict, security-audit, perf-audit, release-prep
495
- - Auth mode tracking in all workflow outputs for telemetry
496
-
497
- **🧪 Comprehensive Testing** - 7 new integration tests for auth strategy:
498
-
499
- - All workflows tested with auth enabled/disabled
500
- - API and subscription mode verification
501
- - Cost tracking validation
502
-
503
- **📖 Documentation** - 950+ lines across 3 guides:
504
-
505
- - [AUTH_STRATEGY_GUIDE.md](docs/AUTH_STRATEGY_GUIDE.md) - User guide for configuration
506
- - [AUTH_CLI_IMPLEMENTATION.md](docs/AUTH_CLI_IMPLEMENTATION.md) - CLI command reference
507
- - [AUTH_WORKFLOW_INTEGRATIONS.md](docs/AUTH_WORKFLOW_INTEGRATIONS.md) - Integration patterns
508
-
509
- [See Full Changelog](CHANGELOG.md#510---2026-01-29)
510
-
511
- ---
512
-
513
- ## What's New in v5.0.2
514
-
515
- **💰 50% Cost Savings with Batch API** - Process non-urgent tasks asynchronously:
516
-
517
- ```bash
518
- empathy batch submit batch_requests.json # Submit batch job
519
- empathy batch status msgbatch_abc123 # Check progress
520
- empathy batch results msgbatch_abc123 output.json # Download results
521
- ```
522
-
523
- Perfect for: log analysis, report generation, bulk classification, test generation
524
-
525
- **📊 Precise Token Counting** - >98% accurate cost tracking:
526
-
527
- - Integrated Anthropic's `count_tokens()` API for billing-accurate measurements
528
- - 3-tier fallback: API → tiktoken (local) → heuristic
529
- - Cache-aware cost calculation (25% write markup, 90% read discount)
530
-
531
- **📈 Cache Performance Monitoring** - Track your 20-30% caching savings:
532
-
533
- ```bash
534
- empathy cache stats # Show hit rates and cost savings
535
- empathy cache stats --verbose # Detailed token metrics
536
- empathy cache stats --format json # Machine-readable output
537
- ```
538
-
539
- **🧭 Adaptive Routing Analytics** - Intelligent tier recommendations:
540
-
541
- ```bash
542
- empathy routing stats <workflow> # Performance metrics
543
- empathy routing check --all # Tier upgrade recommendations
544
- empathy routing models --provider anthropic # Compare models
545
- ```
546
-
547
- **🔧 Dashboard Fixes** - All 6 agent coordination patterns now operational:
548
- - Agent heartbeats displaying correctly
549
- - Event streaming functional
550
- - Coordination signals working
551
- - Approval gates operational
552
-
553
- [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)
554
-
555
- ---
556
-
557
- ## What's New in v4.9.0
558
-
559
- **⚡ 18x Faster Performance** - Massive performance gains through Phase 2 optimizations:
560
-
561
- - **Redis Two-Tier Caching:** 2x faster memory operations (37,000x for cached keys)
562
- - **Generator Expressions:** 99.9% memory reduction across 27 optimizations
563
- - **Parallel Scanning:** Multi-core processing enabled by default (2-4x faster)
564
- - **Incremental Scanning:** Git diff-based updates (10x faster)
565
-
566
- **🧭 Natural Language Workflows** - Use plain English instead of workflow names:
567
-
568
- ```bash
569
- /workflows "find security vulnerabilities" # → security-audit
570
- /workflows "check code performance" # → perf-audit
571
- /workflows "predict bugs" # → bug-predict
572
- /plan "review my code" # → code-review
573
- ```
574
-
575
- **📊 Real-World Performance:**
576
-
577
- - Combined workflow: 3.59s → 0.2s (**18x faster**)
578
- - Full scan: 3,472 files in 0.98s (was 3.59s)
579
- - Redis cached operations: 37ms → 0.001ms
580
-
581
- **🎯 Improved Navigation:**
582
-
583
- - Split `/workflow` into `/workflows` (automated analysis) and `/plan` (planning/review)
584
- - Clearer hub organization with better categorization
585
- - Natural language routing matches intent to workflow
586
-
587
- [See CHANGELOG.md](CHANGELOG.md) | [Performance Docs](docs/REDIS_OPTIMIZATION_SUMMARY.md)
588
-
589
- ---
590
-
591
- ## What's New in v4.7.0
592
-
593
- **$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.
594
-
595
- **Socratic Workflows** - Interactive discovery through guided questions. Workflows ask what you need rather than requiring upfront configuration.
596
-
597
- **Security Hardened** - Fixed critical vulnerabilities (path traversal, JWT, SSRF).
598
-
599
- **Hub-Based Commands** - Organized workflows into intuitive command hubs.
600
-
601
- ---
602
-
603
- ## Quick Start
604
-
605
- ### 1. Install
606
-
607
- ```bash
608
- pip install empathy-framework[developer]
609
- ```
610
-
611
- ### 2. Configure
612
-
613
- ```bash
614
- # Auto-detect API keys
615
- python -m empathy_os.models.cli provider
616
-
617
- # Or set explicitly
618
- python -m empathy_os.models.cli provider --set anthropic
619
- ```
620
-
621
- ### 3. Use
622
-
623
- **In Claude Code:**
624
-
625
- ```bash
626
- /dev # Developer tools (debug, commit, PR, review)
627
- /testing # Run tests, coverage, benchmarks
628
- /workflows # Automated analysis (security, bugs, perf)
629
- /plan # Planning, TDD, code review
630
- /docs # Documentation generation
631
- /release # Release preparation
632
-
633
- # Natural language support:
634
- /workflows "find security issues"
635
- /plan "review my code"
636
-
637
- # Direct tool access via MCP (v5.1.1+):
638
- # Claude Code automatically discovers Empathy tools through the MCP server
639
- # Just describe what you need in natural language:
640
- "Run a security audit on src/" → Invokes security_audit tool
641
- "Generate tests for config.py" → Invokes test_generation tool
642
- "Check my auth configuration" → Invokes auth_status tool
643
- "Analyze performance bottlenecks" → Invokes performance_audit tool
644
- ```
645
-
646
- **MCP Server Integration (v5.1.1+):**
647
-
648
- Empathy Framework now includes a Model Context Protocol (MCP) server that exposes all workflows as native Claude Code tools:
649
-
650
- - **10 Tools Available:** security_audit, bug_predict, code_review, test_generation, performance_audit, release_prep, auth_status, auth_recommend, telemetry_stats, dashboard_status
651
- - **Automatic Discovery:** No manual configuration needed - Claude Code finds tools via `.claude/mcp.json`
652
- - **Natural Language Access:** Describe your need and Claude invokes the appropriate tool
653
- - **Verification Hooks:** Automatic validation of Python/JSON files and workflow outputs
654
-
655
- To verify MCP integration:
656
-
657
- ```bash
658
- # Check server is running
659
- echo '{"method":"tools/list","params":{}}' | PYTHONPATH=./src python -m empathy_os.mcp.server
660
-
661
- # Restart Claude Code to load the MCP server
662
- # Tools will appear in Claude's tool list automatically
663
- ```
664
-
665
- See [.claude/MCP_TEST_RESULTS.md](.claude/MCP_TEST_RESULTS.md) for full integration details.
666
-
667
- **CLI:**
668
-
669
- ```bash
670
- empathy workflow run security-audit --path ./src
671
- empathy workflow run test-coverage --target 90
672
- empathy telemetry show # View cost savings
673
- ```
674
-
675
- **Python:**
676
-
677
- ```python
678
- from empathy_os import EmpathyOS
679
-
680
- async with EmpathyOS() as empathy:
681
- result = await empathy.level_2_guided(
682
- "Review this code for security issues"
683
- )
684
- print(result["response"])
685
- ```
686
-
687
- ---
688
-
689
- ## Command Hubs
690
-
691
- Workflows are organized into hubs for easy discovery:
692
-
693
- | Hub | Command | Description |
694
- | ----------------- | ------------- | -------------------------------------------- |
695
- | **Developer** | `/dev` | Debug, commit, PR, code review, quality |
696
- | **Testing** | `/testing` | Run tests, coverage analysis, benchmarks |
697
- | **Documentation** | `/docs` | Generate and manage documentation |
698
- | **Release** | `/release` | Release prep, security scan, publishing |
699
- | **Workflows** | `/workflows` | Automated analysis (security, bugs, perf) |
700
- | **Plan** | `/plan` | Planning, TDD, code review, refactoring |
701
- | **Utilities** | `/utilities` | Project init, dependencies, profiling |
702
- | **Learning** | `/learning` | Pattern learning and session evaluation |
703
- | **Context** | `/context` | State management and memory |
704
- | **Agent** | `/agent` | Create and manage custom agents |
705
-
706
- **Natural Language Support:**
707
-
708
- ```bash
709
- # Use plain English - intelligent routing matches your intent
710
- /workflows "find security vulnerabilities" # → security-audit
711
- /workflows "check code performance" # → perf-audit
712
- /workflows "predict bugs" # → bug-predict
713
- /plan "review my code" # → code-review
714
- /plan "help me plan this feature" # → planning
715
-
716
- # Or use traditional workflow names
717
- /workflows security-audit
718
- /plan code-review
719
- ```
720
-
721
- **Interactive menus:**
722
-
723
- ```bash
724
- /dev # Show interactive menu
725
- /dev "debug auth error" # Jump directly to debugging
726
- /testing "run coverage" # Run coverage analysis
727
- /release # Start release preparation
728
- ```
729
-
730
- ---
731
-
732
- ## Socratic Method
733
-
734
- Workflows guide you through discovery instead of requiring upfront configuration:
735
-
736
- ```text
737
- You: /dev
738
-
739
- Claude: What development task do you need?
740
- 1. Debug issue
741
- 2. Create commit
742
- 3. PR workflow
743
- 4. Quality check
744
-
745
- You: 1
746
-
747
- Claude: What error or unexpected behavior are you seeing?
748
- ```
749
-
750
- **How it works:**
751
-
752
- 1. **Discovery** - Workflow asks targeted questions to understand your needs
753
- 2. **Context gathering** - Collects relevant code, errors, and constraints
754
- 3. **Dynamic agent creation** - Assembles the right team based on your answers
755
- 4. **Execution** - Runs with appropriate tier selection
756
-
757
- **Create custom agents with Socratic guidance:**
758
-
759
- ```bash
760
- /agent create # Guided agent creation
761
- /agent team # Build multi-agent teams interactively
762
- ```
763
-
764
- ---
765
-
766
- ## Cost Optimization
767
-
768
- ### Skills = $0 (Claude Code)
769
-
770
- When using Claude Code, workflows run as skills through the Task tool - **no API costs**:
771
-
772
- ```bash
773
- /dev # $0 - uses your Claude subscription
774
- /testing # $0
775
- /release # $0
776
- /agent create # $0
777
- ```
778
-
779
- ### API Mode (CI/CD, Automation)
780
-
781
- For programmatic use, smart tier routing saves 34-86%:
782
-
783
- | Tier | Model | Use Case | Cost |
784
- | ------- | ------------------- | --------------------------- | ----------- |
785
- | CHEAP | Haiku / GPT-4o-mini | Formatting, simple tasks | ~$0.005 |
786
- | CAPABLE | Sonnet / GPT-4o | Bug fixes, code review | ~$0.08 |
787
- | PREMIUM | Opus / o1 | Architecture, complex design | ~$0.45 |
788
-
789
- ```bash
790
- # Track API usage and savings
791
- empathy telemetry savings --days 30
792
- ```
793
-
794
- ---
795
-
796
- ## Key Features
797
-
798
- ### Multi-Agent Workflows
799
-
800
- ```bash
801
- # 4 parallel agents check release readiness
802
- empathy orchestrate release-prep
803
-
804
- # Sequential coverage improvement
805
- empathy orchestrate test-coverage --target 90
806
- ```
807
-
808
- ### Response Caching
809
-
810
- Up to 57% cache hit rate on similar prompts. Zero config needed.
811
-
812
- ```python
813
- from empathy_os.workflows import SecurityAuditWorkflow
814
-
815
- workflow = SecurityAuditWorkflow(enable_cache=True)
816
- result = await workflow.execute(target_path="./src")
817
- print(f"Cache hit rate: {result.cost_report.cache_hit_rate:.1f}%")
818
- ```
819
-
820
- ### Pattern Learning
821
-
822
- Workflows learn from outcomes and improve over time:
823
-
824
- ```python
825
- from empathy_os.orchestration.config_store import ConfigurationStore
826
-
827
- store = ConfigurationStore()
828
- best = store.get_best_for_task("release_prep")
829
- print(f"Success rate: {best.success_rate:.1%}")
830
- ```
831
-
832
- ### Multi-Provider Support
833
-
834
- ```python
835
- from empathy_llm_toolkit.providers import (
836
- AnthropicProvider, # Claude
837
- OpenAIProvider, # GPT-4
838
- GeminiProvider, # Gemini
839
- LocalProvider, # Ollama, LM Studio
840
- )
841
- ```
842
-
843
- ---
844
-
845
- ## CLI Reference
846
-
847
- ```bash
848
- # Provider configuration
849
- python -m empathy_os.models.cli provider
850
- python -m empathy_os.models.cli provider --set hybrid
851
-
852
- # Workflows
853
- empathy workflow list
854
- empathy workflow run <workflow-name>
855
-
856
- # Cost tracking
857
- empathy telemetry show
858
- empathy telemetry savings --days 30
859
- empathy telemetry export --format csv
860
-
861
- # Orchestration
862
- empathy orchestrate release-prep
863
- empathy orchestrate test-coverage --target 90
864
-
865
- # Meta-workflows
866
- empathy meta-workflow list
867
- empathy meta-workflow run release-prep --real
868
- ```
869
-
870
- ---
871
-
872
- ## Install Options
873
-
874
- ```bash
875
- # Individual developers (recommended)
876
- pip install empathy-framework[developer]
877
-
878
- # All LLM providers
879
- pip install empathy-framework[llm]
880
-
881
- # With caching (semantic similarity)
882
- pip install empathy-framework[cache]
883
-
884
- # Enterprise (auth, rate limiting)
885
- pip install empathy-framework[enterprise]
886
-
887
- # Healthcare (HIPAA compliance)
888
- pip install empathy-framework[healthcare]
889
-
890
- # Development
891
- git clone https://github.com/Smart-AI-Memory/empathy-framework.git
892
- cd empathy-framework && pip install -e .[dev]
893
- ```
894
-
895
- ---
896
-
897
- ## Environment Setup
898
-
899
- ```bash
900
- # At least one provider required
901
- export ANTHROPIC_API_KEY="sk-ant-..."
902
- export OPENAI_API_KEY="sk-..."
903
- export GOOGLE_API_KEY="..."
904
-
905
- # Optional: Redis for memory
906
- export REDIS_URL="redis://localhost:6379"
907
- ```
908
-
909
- ---
910
-
911
- ## VSCode Extension
912
-
913
- Install the Empathy VSCode extension for:
914
-
915
- - **Dashboard** - Health score, costs, patterns
916
- - **One-Click Workflows** - Run from command palette
917
- - **Memory Panel** - Manage Redis and patterns
918
- - **Cost Tracking** - Real-time savings display
919
-
920
- ---
921
-
922
- ## Documentation
923
-
924
- - [Quick Start Guide](docs/quickstart.md)
925
- - [CLI Reference](docs/cli-reference.md)
926
- - [Testing Guide](docs/testing-guide.md)
927
- - [Keyboard Shortcuts](docs/keyboard-shortcuts.md)
928
- - [Full Documentation](https://smartaimemory.com/framework-docs/)
929
-
930
- ---
931
-
932
- ## Security
933
-
934
- - Path traversal protection on all file operations
935
- - JWT authentication with rate limiting
936
- - PII scrubbing in telemetry
937
- - HIPAA/GDPR compliance options
938
- - **Automated security scanning** with 82% accuracy (Phase 3 AST-based detection)
939
-
940
- See [SECURITY.md](SECURITY.md) for vulnerability reporting.
941
-
942
- ### Security Scanning
943
-
944
- **Automated security scanning in CI/CD** - 82% accuracy, blocks critical issues:
945
-
946
- ```bash
947
- # Run security audit locally
948
- empathy workflow run security-audit
949
-
950
- # Scan specific directory
951
- empathy workflow run security-audit --input '{"path":"./src"}'
952
- ```
953
-
954
- **Documentation:**
955
-
956
- - **[Developer Workflow Guide](docs/DEVELOPER_SECURITY_WORKFLOW.md)** - Quick reference for handling security findings (all developers)
957
- - **[CI/CD Integration Guide](docs/CI_SECURITY_SCANNING.md)** - Complete setup and troubleshooting (DevOps, developers)
958
- - **[Scanner Architecture](docs/SECURITY_SCANNER_ARCHITECTURE.md)** - Technical implementation details (engineers, architects)
959
- - **[Remediation Process](docs/SECURITY_REMEDIATION_PROCESS.md)** - 3-phase methodology for improving scanners (security teams, leadership)
960
- - **[API Reference](docs/api-reference/security-scanner.md)** - Complete API documentation (developers extending scanner)
961
-
962
- **Key achievements:**
963
-
964
- - 82.3% reduction in false positives (350 → 62 findings)
965
- - 16x improvement in scanner accuracy
966
- - <15 minute average fix time for critical issues
967
- - Zero critical vulnerabilities in production code
968
-
969
- ---
970
-
971
- ## Contributing
972
-
973
- See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
974
-
975
- ---
976
-
977
- ## License
978
-
979
- **Apache License 2.0** - Free and open source for everyone. Use it, modify it, build commercial products with it. [Details →](LICENSE)
980
-
981
- ---
982
-
983
- ## Acknowledgements
984
-
985
- 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.
986
-
987
- **[View Full Acknowledgements →](ACKNOWLEDGEMENTS.md)**
988
-
989
- Special thanks to:
990
-
991
- - **[Anthropic](https://www.anthropic.com/)** - For Claude AI and the Model Context Protocol
992
- - **[LangChain](https://github.com/langchain-ai/langchain)** - Agent framework powering our meta-orchestration
993
- - **[FastAPI](https://github.com/tiangolo/fastapi)** - Modern Python web framework
994
- - **[pytest](https://github.com/pytest-dev/pytest)** - Testing framework making quality assurance effortless
995
-
996
- And to all 50+ open source projects we depend on. [See the complete list →](ACKNOWLEDGEMENTS.md)
997
-
998
- Want to contribute? See [CONTRIBUTORS.md](CONTRIBUTORS.md)
999
-
1000
- ---
1001
-
1002
- **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)