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,913 +0,0 @@
1
- """Secure MemDocs Integration for Enterprise Privacy
2
-
3
- Combines PII scrubbing, secrets detection, and audit logging with MemDocs pattern storage.
4
- Implements three-tier classification (PUBLIC/INTERNAL/SENSITIVE) with encryption support.
5
-
6
- This module provides the complete security pipeline for storing and retrieving
7
- patterns with full compliance for GDPR, HIPAA, and SOC2 requirements.
8
-
9
- Key Features:
10
- - Automatic PII scrubbing before storage
11
- - Secrets detection with blocking
12
- - Three-tier classification system
13
- - AES-256-GCM encryption for SENSITIVE patterns
14
- - Comprehensive audit logging
15
- - Access control enforcement
16
- - Retention policy management
17
-
18
- Architecture:
19
- User Input → [PII Scrubbing + Secrets Detection (PARALLEL)] → Classification
20
- → Encryption (if SENSITIVE) → MemDocs Storage → Audit Logging
21
-
22
- Reference:
23
- - SECURE_MEMORY_ARCHITECTURE.md: MemDocs Integration Patterns
24
- - ENTERPRISE_PRIVACY_INTEGRATION.md: Phase 2 Implementation
25
-
26
- Copyright 2025 Smart AI Memory, LLC
27
- Licensed under Fair Source 0.9
28
- """
29
-
30
- import concurrent.futures
31
- import hashlib
32
- import os
33
- from datetime import datetime, timedelta
34
- from typing import Any
35
-
36
- import structlog
37
-
38
- from .encryption import HAS_ENCRYPTION, EncryptionManager
39
-
40
- # Import extracted modules for backward compatibility
41
- from .long_term_types import (
42
- DEFAULT_CLASSIFICATION_RULES,
43
- Classification,
44
- ClassificationRules,
45
- PatternMetadata,
46
- PermissionError,
47
- SecurePattern,
48
- SecurityError,
49
- )
50
- from .security.audit_logger import AuditEvent, AuditLogger
51
- from .security.pii_scrubber import PIIScrubber
52
- from .security.secrets_detector import SecretsDetector
53
- from .simple_storage import LongTermMemory
54
- from .storage_backend import MemDocsStorage
55
-
56
- logger = structlog.get_logger(__name__)
57
-
58
- # HAS_ENCRYPTION is now imported from encryption module
59
-
60
- # NOTE: Classification, ClassificationRules, PatternMetadata, SecurePattern,
61
- # EncryptionManager, MemDocsStorage, and LongTermMemory have been extracted to
62
- # separate modules for better modularity. They are imported above and re-exported
63
- # below for backward compatibility.
64
-
65
-
66
- class SecureMemDocsIntegration:
67
- """Secure integration between Claude Memory and MemDocs.
68
-
69
- Enforces enterprise security policies from CLAUDE.md with:
70
- - Automatic PII scrubbing
71
- - Secrets detection and blocking
72
- - Three-tier classification
73
- - Encryption for SENSITIVE data
74
- - Comprehensive audit logging
75
- - Access control enforcement
76
-
77
- Example:
78
- >>> from empathy_llm_toolkit.claude_memory import ClaudeMemoryConfig
79
- >>> config = ClaudeMemoryConfig(enabled=True, load_enterprise=True)
80
- >>> integration = SecureMemDocsIntegration(config)
81
- >>>
82
- >>> # Store pattern with full security pipeline
83
- >>> result = integration.store_pattern(
84
- ... content="Patient diagnosis: diabetes type 2",
85
- ... pattern_type="clinical_protocol",
86
- ... user_id="doctor@hospital.com"
87
- ... )
88
- >>> # Automatically: PII scrubbed, classified as SENSITIVE, encrypted
89
- >>>
90
- >>> # Retrieve with access control
91
- >>> pattern = integration.retrieve_pattern(
92
- ... pattern_id=result["pattern_id"],
93
- ... user_id="doctor@hospital.com"
94
- ... )
95
-
96
- """
97
-
98
- def __init__(
99
- self,
100
- claude_memory_config=None,
101
- storage_dir: str = "./memdocs_storage",
102
- audit_log_dir: str | None = None, # Uses platform-appropriate default if None
103
- classification_rules: dict[Classification, ClassificationRules] | None = None,
104
- enable_encryption: bool = True,
105
- master_key: bytes | None = None,
106
- ):
107
- """Initialize Secure MemDocs Integration.
108
-
109
- Args:
110
- claude_memory_config: Configuration for Claude memory integration
111
- storage_dir: Directory for MemDocs storage
112
- audit_log_dir: Directory for audit logs
113
- classification_rules: Custom classification rules (uses defaults if None)
114
- enable_encryption: Enable encryption for SENSITIVE patterns
115
- master_key: Encryption master key (auto-generated if None)
116
-
117
- """
118
- self.claude_memory_config = claude_memory_config
119
- self.classification_rules = classification_rules or DEFAULT_CLASSIFICATION_RULES
120
-
121
- # Initialize security components
122
- self.pii_scrubber = PIIScrubber()
123
- self.secrets_detector = SecretsDetector()
124
- self.audit_logger = AuditLogger(
125
- log_dir=audit_log_dir,
126
- enable_console_logging=True, # Development mode
127
- )
128
-
129
- # Initialize encryption
130
- self.encryption_enabled = enable_encryption and HAS_ENCRYPTION
131
- self.encryption_manager: EncryptionManager | None = None
132
- if self.encryption_enabled:
133
- self.encryption_manager = EncryptionManager(master_key)
134
- elif enable_encryption:
135
- logger.warning("encryption_disabled", reason="cryptography library not available")
136
-
137
- # Initialize storage backend
138
- self.storage = MemDocsStorage(storage_dir)
139
-
140
- # Load security policies from enterprise CLAUDE.md
141
- self.security_policies = self._load_security_policies()
142
-
143
- logger.info(
144
- "secure_memdocs_initialized",
145
- encryption_enabled=self.encryption_enabled,
146
- storage_dir=storage_dir,
147
- audit_dir=audit_log_dir,
148
- )
149
-
150
- def _load_security_policies(self) -> dict[str, Any]:
151
- """Load security policies from enterprise Claude memory.
152
-
153
- In production, this would parse the enterprise CLAUDE.md file
154
- to extract PII patterns, secret patterns, and classification rules.
155
-
156
- For now, returns default policies that match the architecture spec.
157
- """
158
- policies = {
159
- "pii_scrubbing_enabled": True,
160
- "secrets_detection_enabled": True,
161
- "classification_required": True,
162
- "audit_logging_enabled": True,
163
- "retention_enforcement_enabled": True,
164
- }
165
-
166
- logger.debug("security_policies_loaded", policies=policies)
167
- return policies
168
-
169
- def store_pattern(
170
- self,
171
- content: str,
172
- pattern_type: str,
173
- user_id: str,
174
- auto_classify: bool = True,
175
- explicit_classification: Classification | None = None,
176
- session_id: str = "",
177
- custom_metadata: dict[str, Any] | None = None,
178
- ) -> dict[str, Any]:
179
- """Store a pattern with full security pipeline.
180
-
181
- Pipeline:
182
- 1. PII scrubbing
183
- 2. Secrets detection (blocks if found)
184
- 3. Classification (auto or explicit)
185
- 4. Encryption (if SENSITIVE)
186
- 5. MemDocs storage
187
- 6. Audit logging
188
-
189
- Args:
190
- content: Pattern content to store
191
- pattern_type: Type of pattern (code, architecture, clinical, etc.)
192
- user_id: User storing the pattern
193
- auto_classify: Enable automatic classification
194
- explicit_classification: Override auto-classification
195
- session_id: Session identifier for audit
196
- custom_metadata: Additional metadata
197
-
198
- Returns:
199
- Dictionary with:
200
- - pattern_id: Unique identifier
201
- - classification: Applied classification
202
- - sanitization_report: PII and secrets detection results
203
-
204
- Raises:
205
- SecurityError: If secrets detected or security policy violated
206
- ValueError: If content/pattern_type/user_id empty or invalid classification
207
- TypeError: If custom_metadata is not dict
208
-
209
- Example:
210
- >>> result = integration.store_pattern(
211
- ... content="Patient vital signs protocol",
212
- ... pattern_type="clinical_protocol",
213
- ... user_id="nurse@hospital.com"
214
- ... )
215
- >>> print(f"Stored as {result['classification']}")
216
-
217
- """
218
- logger.info(
219
- "store_pattern_started",
220
- user_id=user_id,
221
- pattern_type=pattern_type,
222
- auto_classify=auto_classify,
223
- )
224
-
225
- try:
226
- # Pattern 1: String ID validation
227
- if not content or not content.strip():
228
- raise ValueError(f"content cannot be empty. Got: {content!r}")
229
- if not pattern_type or not pattern_type.strip():
230
- raise ValueError(f"pattern_type cannot be empty. Got: {pattern_type!r}")
231
- if not user_id or not user_id.strip():
232
- raise ValueError(f"user_id cannot be empty. Got: {user_id!r}")
233
-
234
- # Pattern 5: Type validation
235
- if custom_metadata is not None and not isinstance(custom_metadata, dict):
236
- raise TypeError(
237
- f"custom_metadata must be dict, got {type(custom_metadata).__name__}"
238
- )
239
-
240
- # Step 1 & 2: PII Scrubbing + Secrets Detection (PARALLEL for performance)
241
- # Run both operations in parallel since they're independent
242
- # Secrets detection runs on original content to catch secrets before PII scrubbing
243
- with concurrent.futures.ThreadPoolExecutor(max_workers=2) as executor:
244
- # Submit both tasks in parallel
245
- pii_future = executor.submit(self.pii_scrubber.scrub, content)
246
- secrets_future = executor.submit(self.secrets_detector.detect, content)
247
-
248
- # Wait for both to complete
249
- sanitized_content, pii_detections = pii_future.result()
250
- secrets_found = secrets_future.result()
251
-
252
- pii_count = len(pii_detections)
253
-
254
- if pii_count > 0:
255
- logger.info(
256
- "pii_scrubbed",
257
- user_id=user_id,
258
- pii_count=pii_count,
259
- types=[d.pii_type for d in pii_detections],
260
- )
261
-
262
- if secrets_found:
263
- # CRITICAL: Block storage if secrets detected
264
- secret_types = [s.secret_type.value for s in secrets_found]
265
- logger.error(
266
- "secrets_detected_blocking_storage",
267
- user_id=user_id,
268
- secret_count=len(secrets_found),
269
- types=secret_types,
270
- )
271
-
272
- # Log to audit trail
273
- self.audit_logger.log_security_violation(
274
- user_id=user_id,
275
- violation_type="secrets_in_storage_attempt",
276
- severity="CRITICAL",
277
- details={
278
- "secret_count": len(secrets_found),
279
- "secret_types": secret_types,
280
- "pattern_type": pattern_type,
281
- },
282
- session_id=session_id,
283
- blocked=True,
284
- )
285
-
286
- raise SecurityError(
287
- f"Secrets detected in pattern. Cannot store. Found: {secret_types}",
288
- )
289
-
290
- # Step 3: Classification
291
- if explicit_classification:
292
- classification = explicit_classification
293
- logger.info("explicit_classification", classification=classification.value)
294
- elif auto_classify:
295
- classification = self._classify_pattern(sanitized_content, pattern_type)
296
- logger.info("auto_classification", classification=classification.value)
297
- else:
298
- # Default to INTERNAL if not specified
299
- classification = Classification.INTERNAL
300
- logger.info("default_classification", classification=classification.value)
301
-
302
- # Step 4: Apply classification-specific controls
303
- rules = self.classification_rules[classification]
304
-
305
- # Encrypt if required
306
- final_content = sanitized_content
307
- encrypted = False
308
-
309
- if rules.encryption_required and self.encryption_enabled and self.encryption_manager:
310
- final_content = self.encryption_manager.encrypt(sanitized_content)
311
- encrypted = True
312
- logger.info("pattern_encrypted", classification=classification.value)
313
- elif rules.encryption_required and not self.encryption_enabled:
314
- logger.warning(
315
- "encryption_required_but_unavailable",
316
- classification=classification.value,
317
- action="storing_unencrypted",
318
- )
319
-
320
- # Generate pattern ID
321
- pattern_id = self._generate_pattern_id(user_id, pattern_type)
322
-
323
- # Step 5: Store in MemDocs with metadata
324
- metadata = PatternMetadata(
325
- pattern_id=pattern_id,
326
- created_by=user_id,
327
- created_at=datetime.utcnow().isoformat() + "Z",
328
- classification=classification.value,
329
- retention_days=rules.retention_days,
330
- encrypted=encrypted,
331
- pattern_type=pattern_type,
332
- sanitization_applied=True,
333
- pii_removed=pii_count,
334
- secrets_detected=0,
335
- access_control={
336
- "access_level": rules.access_level,
337
- "audit_required": rules.audit_all_access,
338
- },
339
- custom_metadata=custom_metadata or {},
340
- )
341
-
342
- self.storage.store(
343
- pattern_id=pattern_id,
344
- content=final_content,
345
- metadata=metadata.__dict__,
346
- )
347
-
348
- # Step 6: Audit logging
349
- self.audit_logger.log_pattern_store(
350
- user_id=user_id,
351
- pattern_id=pattern_id,
352
- pattern_type=pattern_type,
353
- classification=classification.value,
354
- pii_scrubbed=pii_count,
355
- secrets_detected=0,
356
- retention_days=rules.retention_days,
357
- encrypted=encrypted,
358
- session_id=session_id,
359
- status="success",
360
- )
361
-
362
- logger.info(
363
- "pattern_stored_successfully",
364
- pattern_id=pattern_id,
365
- classification=classification.value,
366
- encrypted=encrypted,
367
- )
368
-
369
- return {
370
- "pattern_id": pattern_id,
371
- "classification": classification.value,
372
- "sanitization_report": {
373
- "pii_removed": [{"type": d.pii_type, "count": 1} for d in pii_detections],
374
- "pii_count": pii_count,
375
- "secrets_detected": 0,
376
- },
377
- "metadata": {
378
- "encrypted": encrypted,
379
- "retention_days": rules.retention_days,
380
- "created_at": metadata.created_at,
381
- },
382
- }
383
-
384
- except SecurityError:
385
- # Re-raise security errors
386
- raise
387
- except Exception as e:
388
- # Log unexpected errors
389
- logger.error("pattern_storage_failed", user_id=user_id, error=str(e))
390
-
391
- self.audit_logger.log_pattern_store(
392
- user_id=user_id,
393
- pattern_id="",
394
- pattern_type=pattern_type,
395
- classification="UNKNOWN",
396
- pii_scrubbed=0,
397
- secrets_detected=0,
398
- retention_days=0,
399
- encrypted=False,
400
- session_id=session_id,
401
- status="failed",
402
- error=str(e),
403
- )
404
-
405
- raise
406
-
407
- def retrieve_pattern(
408
- self,
409
- pattern_id: str,
410
- user_id: str,
411
- check_permissions: bool = True,
412
- session_id: str = "",
413
- ) -> dict[str, Any]:
414
- """Retrieve a pattern with access control and decryption.
415
-
416
- Pipeline:
417
- 1. Retrieve from MemDocs
418
- 2. Check access permissions
419
- 3. Decrypt (if SENSITIVE)
420
- 4. Check retention policy
421
- 5. Audit logging
422
-
423
- Args:
424
- pattern_id: Unique pattern identifier
425
- user_id: User retrieving the pattern
426
- check_permissions: Enforce access control
427
- session_id: Session identifier for audit
428
-
429
- Returns:
430
- Dictionary with:
431
- - content: Pattern content (decrypted if needed)
432
- - metadata: Pattern metadata
433
-
434
- Raises:
435
- PermissionError: If access denied
436
- ValueError: If pattern_id/user_id empty, pattern not found, or retention expired
437
- SecurityError: If decryption fails
438
-
439
- Example:
440
- >>> pattern = integration.retrieve_pattern(
441
- ... pattern_id="pat_abc123",
442
- ... user_id="user@company.com"
443
- ... )
444
- >>> print(pattern["content"])
445
-
446
- """
447
- # Pattern 1: String ID validation
448
- if not pattern_id or not pattern_id.strip():
449
- raise ValueError(f"pattern_id cannot be empty. Got: {pattern_id!r}")
450
- if not user_id or not user_id.strip():
451
- raise ValueError("user_id cannot be empty")
452
-
453
- logger.info(
454
- "retrieve_pattern_started",
455
- pattern_id=pattern_id,
456
- user_id=user_id,
457
- check_permissions=check_permissions,
458
- )
459
-
460
- try:
461
- # Step 1: Retrieve from MemDocs
462
- pattern_data = self.storage.retrieve(pattern_id)
463
-
464
- if not pattern_data:
465
- logger.warning("pattern_not_found", pattern_id=pattern_id)
466
- raise ValueError(f"Pattern {pattern_id} not found")
467
-
468
- content = pattern_data["content"]
469
- metadata = pattern_data["metadata"]
470
- classification = Classification[metadata["classification"]]
471
-
472
- # Step 2: Check access permissions
473
- access_granted = True
474
- if check_permissions:
475
- access_granted = self._check_access(
476
- user_id=user_id,
477
- classification=classification,
478
- metadata=metadata,
479
- )
480
-
481
- if not access_granted:
482
- logger.warning(
483
- "access_denied",
484
- pattern_id=pattern_id,
485
- user_id=user_id,
486
- classification=classification.value,
487
- )
488
-
489
- # Log access denial
490
- self.audit_logger.log_pattern_retrieve(
491
- user_id=user_id,
492
- pattern_id=pattern_id,
493
- classification=classification.value,
494
- access_granted=False,
495
- session_id=session_id,
496
- status="blocked",
497
- error="Access denied",
498
- )
499
-
500
- raise PermissionError(
501
- f"User {user_id} does not have access to {classification.value} pattern",
502
- )
503
-
504
- # Step 3: Decrypt if needed
505
- if metadata.get("encrypted", False):
506
- if not self.encryption_enabled:
507
- logger.error("decryption_required_but_unavailable", pattern_id=pattern_id)
508
- raise SecurityError("Encryption not available for decryption")
509
-
510
- if self.encryption_manager:
511
- content = self.encryption_manager.decrypt(content)
512
- logger.debug("pattern_decrypted", pattern_id=pattern_id)
513
-
514
- # Step 4: Check retention policy
515
- created_at = datetime.fromisoformat(metadata["created_at"].rstrip("Z"))
516
- retention_days = metadata["retention_days"]
517
- expiration_date = created_at + timedelta(days=retention_days)
518
-
519
- if datetime.utcnow() > expiration_date:
520
- logger.warning(
521
- "pattern_retention_expired",
522
- pattern_id=pattern_id,
523
- created_at=metadata["created_at"],
524
- retention_days=retention_days,
525
- )
526
- raise ValueError(
527
- f"Pattern {pattern_id} has expired retention period "
528
- f"(created: {metadata['created_at']}, retention: {retention_days} days)",
529
- )
530
-
531
- # Step 5: Audit logging
532
- self.audit_logger.log_pattern_retrieve(
533
- user_id=user_id,
534
- pattern_id=pattern_id,
535
- classification=classification.value,
536
- access_granted=True,
537
- permission_level=metadata["access_control"]["access_level"],
538
- session_id=session_id,
539
- status="success",
540
- )
541
-
542
- logger.info(
543
- "pattern_retrieved_successfully",
544
- pattern_id=pattern_id,
545
- classification=classification.value,
546
- )
547
-
548
- return {"content": content, "metadata": metadata}
549
-
550
- except (PermissionError, ValueError, SecurityError):
551
- # Re-raise expected errors
552
- raise
553
- except Exception as e:
554
- # Log unexpected errors
555
- logger.error("pattern_retrieval_failed", pattern_id=pattern_id, error=str(e))
556
-
557
- self.audit_logger.log_pattern_retrieve(
558
- user_id=user_id,
559
- pattern_id=pattern_id,
560
- classification="UNKNOWN",
561
- access_granted=False,
562
- session_id=session_id,
563
- status="failed",
564
- error=str(e),
565
- )
566
-
567
- raise
568
-
569
- def _classify_pattern(self, content: str, pattern_type: str) -> Classification:
570
- """Auto-classify pattern based on content and type.
571
-
572
- Classification heuristics:
573
- - SENSITIVE: Healthcare, financial, regulated data keywords
574
- - INTERNAL: Proprietary, confidential, internal keywords
575
- - PUBLIC: Everything else (general patterns)
576
-
577
- Args:
578
- content: Pattern content (already PII-scrubbed)
579
- pattern_type: Type of pattern
580
-
581
- Returns:
582
- Classification level
583
-
584
- """
585
- content_lower = content.lower()
586
-
587
- # SENSITIVE: Healthcare keywords (HIPAA)
588
- healthcare_keywords = [
589
- "patient",
590
- "medical",
591
- "diagnosis",
592
- "treatment",
593
- "healthcare",
594
- "clinical",
595
- "hipaa",
596
- "phi",
597
- "medical record",
598
- "prescription",
599
- ]
600
-
601
- # SENSITIVE: Financial keywords
602
- financial_keywords = [
603
- "financial",
604
- "payment",
605
- "credit card",
606
- "banking",
607
- "transaction",
608
- "pci dss",
609
- "payment card",
610
- ]
611
-
612
- # INTERNAL: Proprietary keywords
613
- proprietary_keywords = [
614
- "proprietary",
615
- "confidential",
616
- "internal",
617
- "trade secret",
618
- "company confidential",
619
- "restricted",
620
- ]
621
-
622
- # Check for SENSITIVE indicators
623
- if any(keyword in content_lower for keyword in healthcare_keywords):
624
- return Classification.SENSITIVE
625
-
626
- if any(keyword in content_lower for keyword in financial_keywords):
627
- return Classification.SENSITIVE
628
-
629
- # Pattern type based classification
630
- if pattern_type in [
631
- "clinical_protocol",
632
- "medical_guideline",
633
- "patient_workflow",
634
- "financial_procedure",
635
- ]:
636
- return Classification.SENSITIVE
637
-
638
- # Check for INTERNAL indicators
639
- if any(keyword in content_lower for keyword in proprietary_keywords):
640
- return Classification.INTERNAL
641
-
642
- if pattern_type in ["architecture", "business_logic", "company_process"]:
643
- return Classification.INTERNAL
644
-
645
- # Default to PUBLIC for general patterns
646
- return Classification.PUBLIC
647
-
648
- def _check_access(
649
- self,
650
- user_id: str,
651
- classification: Classification,
652
- metadata: dict[str, Any],
653
- ) -> bool:
654
- """Check if user has access to pattern based on classification.
655
-
656
- Access rules:
657
- - PUBLIC: All users
658
- - INTERNAL: Users on project team (simplified: always granted for demo)
659
- - SENSITIVE: Explicit permission required (simplified: creator only)
660
-
661
- Args:
662
- user_id: User requesting access
663
- classification: Pattern classification
664
- metadata: Pattern metadata
665
-
666
- Returns:
667
- True if access granted, False otherwise
668
-
669
- """
670
- # PUBLIC: Everyone has access
671
- if classification == Classification.PUBLIC:
672
- return True
673
-
674
- # INTERNAL: Check project team membership
675
- # Simplified: Grant access (production would check team membership)
676
- if classification == Classification.INTERNAL:
677
- logger.debug("internal_access_check", user_id=user_id, granted=True)
678
- return True
679
-
680
- # SENSITIVE: Require explicit permission
681
- # Simplified: Only pattern creator has access
682
- if classification == Classification.SENSITIVE:
683
- created_by = str(metadata.get("created_by", ""))
684
- granted = user_id == created_by
685
-
686
- logger.debug(
687
- "sensitive_access_check",
688
- user_id=user_id,
689
- created_by=created_by,
690
- granted=granted,
691
- )
692
-
693
- return bool(granted)
694
-
695
- # Default deny
696
- return False
697
-
698
- def _generate_pattern_id(self, user_id: str, pattern_type: str) -> str:
699
- """Generate unique pattern ID.
700
-
701
- Format: pat_{timestamp}_{hash}
702
-
703
- Args:
704
- user_id: User creating the pattern
705
- pattern_type: Type of pattern
706
-
707
- Returns:
708
- Unique pattern identifier
709
-
710
- """
711
- timestamp = datetime.utcnow().strftime("%Y%m%d%H%M%S")
712
-
713
- # Create hash from user_id, pattern_type, and random component
714
- hash_input = f"{user_id}:{pattern_type}:{timestamp}:{os.urandom(8).hex()}"
715
- hash_digest = hashlib.sha256(hash_input.encode()).hexdigest()[:12]
716
-
717
- return f"pat_{timestamp}_{hash_digest}"
718
-
719
- def list_patterns(
720
- self,
721
- user_id: str,
722
- classification: Classification | None = None,
723
- pattern_type: str | None = None,
724
- ) -> list[dict[str, Any]]:
725
- """List patterns accessible to user.
726
-
727
- Args:
728
- user_id: User listing patterns
729
- classification: Filter by classification
730
- pattern_type: Filter by pattern type
731
-
732
- Returns:
733
- List of pattern summaries
734
-
735
- """
736
- all_pattern_ids = self.storage.list_patterns()
737
- accessible_patterns = []
738
-
739
- for pattern_id in all_pattern_ids:
740
- try:
741
- pattern_data = self.storage.retrieve(pattern_id)
742
- if not pattern_data:
743
- continue
744
-
745
- metadata = pattern_data["metadata"]
746
- pat_classification = Classification[metadata["classification"]]
747
-
748
- # Apply filters
749
- if classification and pat_classification != classification:
750
- continue
751
-
752
- if pattern_type and metadata.get("pattern_type") != pattern_type:
753
- continue
754
-
755
- # Check access
756
- if self._check_access(user_id, pat_classification, metadata):
757
- accessible_patterns.append(
758
- {
759
- "pattern_id": pattern_id,
760
- "pattern_type": metadata.get("pattern_type"),
761
- "classification": metadata["classification"],
762
- "created_by": metadata.get("created_by"),
763
- "created_at": metadata.get("created_at"),
764
- "encrypted": metadata.get("encrypted", False),
765
- },
766
- )
767
-
768
- except Exception as e:
769
- logger.warning(
770
- "failed_to_load_pattern_metadata",
771
- pattern_id=pattern_id,
772
- error=str(e),
773
- )
774
- continue
775
-
776
- return accessible_patterns
777
-
778
- def delete_pattern(self, pattern_id: str, user_id: str, session_id: str = "") -> bool:
779
- """Delete a pattern (with access control).
780
-
781
- Args:
782
- pattern_id: Pattern to delete
783
- user_id: User requesting deletion
784
- session_id: Session identifier
785
-
786
- Returns:
787
- True if deleted successfully
788
-
789
- Raises:
790
- PermissionError: If user doesn't have permission to delete
791
- ValueError: If pattern_id or user_id is empty
792
-
793
- """
794
- # Pattern 1: String ID validation
795
- if not pattern_id or not pattern_id.strip():
796
- raise ValueError(f"pattern_id cannot be empty. Got: {pattern_id!r}")
797
- if not user_id or not user_id.strip():
798
- raise ValueError("user_id cannot be empty")
799
-
800
- # Retrieve pattern to check permissions
801
- pattern_data = self.storage.retrieve(pattern_id)
802
-
803
- if not pattern_data:
804
- logger.warning("pattern_not_found_for_deletion", pattern_id=pattern_id)
805
- return False
806
-
807
- metadata = pattern_data["metadata"]
808
-
809
- # Only creator can delete (simplified access control)
810
- if metadata.get("created_by") != user_id:
811
- logger.warning(
812
- "delete_permission_denied",
813
- pattern_id=pattern_id,
814
- user_id=user_id,
815
- created_by=metadata.get("created_by"),
816
- )
817
- raise PermissionError(f"User {user_id} cannot delete pattern {pattern_id}")
818
-
819
- # Delete pattern
820
- deleted = self.storage.delete(pattern_id)
821
-
822
- if deleted:
823
- # Log deletion
824
- self.audit_logger._write_event(
825
- AuditEvent(
826
- event_type="delete_pattern",
827
- user_id=user_id,
828
- session_id=session_id,
829
- status="success",
830
- data={
831
- "pattern_id": pattern_id,
832
- "classification": metadata["classification"],
833
- },
834
- ),
835
- )
836
-
837
- logger.info("pattern_deleted", pattern_id=pattern_id, user_id=user_id)
838
-
839
- return deleted
840
-
841
- def get_statistics(self) -> dict[str, Any]:
842
- """Get statistics about stored patterns.
843
-
844
- Returns:
845
- Dictionary with pattern statistics
846
-
847
- """
848
- all_patterns = self.storage.list_patterns()
849
-
850
- stats: dict[str, Any] = {
851
- "total_patterns": len(all_patterns),
852
- "by_classification": {
853
- "PUBLIC": 0,
854
- "INTERNAL": 0,
855
- "SENSITIVE": 0,
856
- },
857
- "encrypted_count": 0,
858
- "with_pii_scrubbed": 0,
859
- }
860
-
861
- for pattern_id in all_patterns:
862
- try:
863
- pattern_data = self.storage.retrieve(pattern_id)
864
- if not pattern_data:
865
- continue
866
-
867
- metadata = pattern_data["metadata"]
868
- classification = metadata.get("classification", "INTERNAL")
869
-
870
- stats["by_classification"][classification] += 1
871
-
872
- if metadata.get("encrypted", False):
873
- stats["encrypted_count"] += 1
874
-
875
- if metadata.get("pii_removed", 0) > 0:
876
- stats["with_pii_scrubbed"] += 1
877
-
878
- except Exception:
879
- continue
880
-
881
- return stats
882
-
883
-
884
- # ============================================================================
885
- # Simplified Long-Term Memory Interface
886
- # ============================================================================
887
-
888
-
889
-
890
-
891
- # ============================================================================
892
- # Backward Compatibility Exports
893
- # ============================================================================
894
-
895
- __all__ = [
896
- # Types (from long_term_types.py)
897
- "Classification",
898
- "ClassificationRules",
899
- "DEFAULT_CLASSIFICATION_RULES",
900
- "PatternMetadata",
901
- "SecurePattern",
902
- "SecurityError",
903
- "PermissionError",
904
- # Encryption (from encryption.py)
905
- "EncryptionManager",
906
- "HAS_ENCRYPTION",
907
- # Storage (from storage_backend.py)
908
- "MemDocsStorage",
909
- # Simple storage (from simple_storage.py)
910
- "LongTermMemory",
911
- # Main integration (defined in this file)
912
- "SecureMemDocsIntegration",
913
- ]