tapps-agents 3.5.40__py3-none-any.whl → 3.6.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 (705) hide show
  1. tapps_agents/__init__.py +2 -2
  2. tapps_agents/agents/__init__.py +22 -22
  3. tapps_agents/agents/analyst/__init__.py +5 -5
  4. tapps_agents/agents/architect/__init__.py +5 -5
  5. tapps_agents/agents/architect/agent.py +1033 -1033
  6. tapps_agents/agents/architect/pattern_detector.py +75 -75
  7. tapps_agents/agents/cleanup/__init__.py +7 -7
  8. tapps_agents/agents/cleanup/agent.py +445 -445
  9. tapps_agents/agents/debugger/__init__.py +7 -7
  10. tapps_agents/agents/debugger/agent.py +310 -310
  11. tapps_agents/agents/debugger/error_analyzer.py +437 -437
  12. tapps_agents/agents/designer/__init__.py +5 -5
  13. tapps_agents/agents/designer/agent.py +786 -786
  14. tapps_agents/agents/designer/visual_designer.py +638 -638
  15. tapps_agents/agents/documenter/__init__.py +7 -7
  16. tapps_agents/agents/documenter/agent.py +531 -531
  17. tapps_agents/agents/documenter/doc_generator.py +472 -472
  18. tapps_agents/agents/documenter/doc_validator.py +393 -393
  19. tapps_agents/agents/documenter/framework_doc_updater.py +493 -493
  20. tapps_agents/agents/enhancer/__init__.py +7 -7
  21. tapps_agents/agents/evaluator/__init__.py +7 -7
  22. tapps_agents/agents/evaluator/agent.py +443 -443
  23. tapps_agents/agents/evaluator/priority_evaluator.py +641 -641
  24. tapps_agents/agents/evaluator/quality_analyzer.py +147 -147
  25. tapps_agents/agents/evaluator/report_generator.py +344 -344
  26. tapps_agents/agents/evaluator/usage_analyzer.py +192 -192
  27. tapps_agents/agents/evaluator/workflow_analyzer.py +189 -189
  28. tapps_agents/agents/implementer/__init__.py +7 -7
  29. tapps_agents/agents/implementer/agent.py +798 -798
  30. tapps_agents/agents/implementer/auto_fix.py +1119 -1119
  31. tapps_agents/agents/implementer/code_generator.py +73 -73
  32. tapps_agents/agents/improver/__init__.py +1 -1
  33. tapps_agents/agents/improver/agent.py +753 -753
  34. tapps_agents/agents/ops/__init__.py +1 -1
  35. tapps_agents/agents/ops/agent.py +619 -619
  36. tapps_agents/agents/ops/dependency_analyzer.py +600 -600
  37. tapps_agents/agents/orchestrator/__init__.py +5 -5
  38. tapps_agents/agents/orchestrator/agent.py +522 -522
  39. tapps_agents/agents/planner/__init__.py +7 -7
  40. tapps_agents/agents/planner/agent.py +1127 -1127
  41. tapps_agents/agents/reviewer/__init__.py +24 -24
  42. tapps_agents/agents/reviewer/agent.py +3513 -3513
  43. tapps_agents/agents/reviewer/aggregator.py +213 -213
  44. tapps_agents/agents/reviewer/batch_review.py +448 -448
  45. tapps_agents/agents/reviewer/cache.py +443 -443
  46. tapps_agents/agents/reviewer/context7_enhancer.py +630 -630
  47. tapps_agents/agents/reviewer/context_detector.py +203 -203
  48. tapps_agents/agents/reviewer/docker_compose_validator.py +158 -158
  49. tapps_agents/agents/reviewer/dockerfile_validator.py +176 -176
  50. tapps_agents/agents/reviewer/error_handling.py +126 -126
  51. tapps_agents/agents/reviewer/feedback_generator.py +490 -490
  52. tapps_agents/agents/reviewer/influxdb_validator.py +316 -316
  53. tapps_agents/agents/reviewer/issue_tracking.py +169 -169
  54. tapps_agents/agents/reviewer/library_detector.py +295 -295
  55. tapps_agents/agents/reviewer/library_patterns.py +268 -268
  56. tapps_agents/agents/reviewer/maintainability_scorer.py +593 -593
  57. tapps_agents/agents/reviewer/metric_strategies.py +276 -276
  58. tapps_agents/agents/reviewer/mqtt_validator.py +160 -160
  59. tapps_agents/agents/reviewer/output_enhancer.py +105 -105
  60. tapps_agents/agents/reviewer/pattern_detector.py +241 -241
  61. tapps_agents/agents/reviewer/performance_scorer.py +357 -357
  62. tapps_agents/agents/reviewer/phased_review.py +516 -516
  63. tapps_agents/agents/reviewer/progressive_review.py +435 -435
  64. tapps_agents/agents/reviewer/react_scorer.py +331 -331
  65. tapps_agents/agents/reviewer/score_constants.py +228 -228
  66. tapps_agents/agents/reviewer/score_validator.py +507 -507
  67. tapps_agents/agents/reviewer/scorer_registry.py +373 -373
  68. tapps_agents/agents/reviewer/scoring.py +1566 -1566
  69. tapps_agents/agents/reviewer/service_discovery.py +534 -534
  70. tapps_agents/agents/reviewer/tools/__init__.py +41 -41
  71. tapps_agents/agents/reviewer/tools/parallel_executor.py +581 -581
  72. tapps_agents/agents/reviewer/tools/ruff_grouping.py +250 -250
  73. tapps_agents/agents/reviewer/tools/scoped_mypy.py +284 -284
  74. tapps_agents/agents/reviewer/typescript_scorer.py +1142 -1142
  75. tapps_agents/agents/reviewer/validation.py +208 -208
  76. tapps_agents/agents/reviewer/websocket_validator.py +132 -132
  77. tapps_agents/agents/tester/__init__.py +7 -7
  78. tapps_agents/agents/tester/accessibility_auditor.py +309 -309
  79. tapps_agents/agents/tester/agent.py +1080 -1080
  80. tapps_agents/agents/tester/batch_generator.py +54 -54
  81. tapps_agents/agents/tester/context_learner.py +51 -51
  82. tapps_agents/agents/tester/coverage_analyzer.py +386 -386
  83. tapps_agents/agents/tester/coverage_test_generator.py +290 -290
  84. tapps_agents/agents/tester/debug_enhancer.py +238 -238
  85. tapps_agents/agents/tester/device_emulator.py +241 -241
  86. tapps_agents/agents/tester/integration_generator.py +62 -62
  87. tapps_agents/agents/tester/network_recorder.py +300 -300
  88. tapps_agents/agents/tester/performance_monitor.py +320 -320
  89. tapps_agents/agents/tester/test_fixer.py +316 -316
  90. tapps_agents/agents/tester/test_generator.py +632 -632
  91. tapps_agents/agents/tester/trace_manager.py +234 -234
  92. tapps_agents/agents/tester/visual_regression.py +291 -291
  93. tapps_agents/analysis/pattern_detector.py +36 -36
  94. tapps_agents/beads/hydration.py +213 -213
  95. tapps_agents/beads/parse.py +32 -32
  96. tapps_agents/beads/specs.py +206 -206
  97. tapps_agents/cli/__init__.py +9 -9
  98. tapps_agents/cli/__main__.py +8 -8
  99. tapps_agents/cli/base.py +478 -478
  100. tapps_agents/cli/command_classifier.py +72 -72
  101. tapps_agents/cli/commands/__init__.py +2 -2
  102. tapps_agents/cli/commands/analyst.py +173 -173
  103. tapps_agents/cli/commands/architect.py +109 -109
  104. tapps_agents/cli/commands/cleanup_agent.py +92 -92
  105. tapps_agents/cli/commands/common.py +126 -126
  106. tapps_agents/cli/commands/debugger.py +90 -90
  107. tapps_agents/cli/commands/designer.py +112 -112
  108. tapps_agents/cli/commands/documenter.py +136 -136
  109. tapps_agents/cli/commands/enhancer.py +110 -110
  110. tapps_agents/cli/commands/evaluator.py +255 -255
  111. tapps_agents/cli/commands/health.py +665 -665
  112. tapps_agents/cli/commands/implementer.py +301 -301
  113. tapps_agents/cli/commands/improver.py +91 -91
  114. tapps_agents/cli/commands/knowledge.py +111 -111
  115. tapps_agents/cli/commands/learning.py +172 -172
  116. tapps_agents/cli/commands/observability.py +283 -283
  117. tapps_agents/cli/commands/ops.py +135 -135
  118. tapps_agents/cli/commands/orchestrator.py +116 -116
  119. tapps_agents/cli/commands/planner.py +237 -237
  120. tapps_agents/cli/commands/reviewer.py +1872 -1872
  121. tapps_agents/cli/commands/status.py +285 -285
  122. tapps_agents/cli/commands/task.py +227 -219
  123. tapps_agents/cli/commands/tester.py +191 -191
  124. tapps_agents/cli/commands/top_level.py +3586 -3586
  125. tapps_agents/cli/feedback.py +936 -936
  126. tapps_agents/cli/formatters.py +608 -608
  127. tapps_agents/cli/help/__init__.py +7 -7
  128. tapps_agents/cli/help/static_help.py +425 -425
  129. tapps_agents/cli/network_detection.py +110 -110
  130. tapps_agents/cli/output_compactor.py +274 -274
  131. tapps_agents/cli/parsers/__init__.py +2 -2
  132. tapps_agents/cli/parsers/analyst.py +186 -186
  133. tapps_agents/cli/parsers/architect.py +167 -167
  134. tapps_agents/cli/parsers/cleanup_agent.py +228 -228
  135. tapps_agents/cli/parsers/debugger.py +116 -116
  136. tapps_agents/cli/parsers/designer.py +182 -182
  137. tapps_agents/cli/parsers/documenter.py +134 -134
  138. tapps_agents/cli/parsers/enhancer.py +113 -113
  139. tapps_agents/cli/parsers/evaluator.py +213 -213
  140. tapps_agents/cli/parsers/implementer.py +168 -168
  141. tapps_agents/cli/parsers/improver.py +132 -132
  142. tapps_agents/cli/parsers/ops.py +159 -159
  143. tapps_agents/cli/parsers/orchestrator.py +98 -98
  144. tapps_agents/cli/parsers/planner.py +145 -145
  145. tapps_agents/cli/parsers/reviewer.py +462 -462
  146. tapps_agents/cli/parsers/tester.py +124 -124
  147. tapps_agents/cli/progress_heartbeat.py +254 -254
  148. tapps_agents/cli/streaming_progress.py +336 -336
  149. tapps_agents/cli/utils/__init__.py +6 -6
  150. tapps_agents/cli/utils/agent_lifecycle.py +48 -48
  151. tapps_agents/cli/utils/error_formatter.py +82 -82
  152. tapps_agents/cli/utils/error_recovery.py +188 -188
  153. tapps_agents/cli/utils/output_handler.py +59 -59
  154. tapps_agents/cli/utils/prompt_enhancer.py +319 -319
  155. tapps_agents/cli/validators/__init__.py +9 -9
  156. tapps_agents/cli/validators/command_validator.py +81 -81
  157. tapps_agents/context7/__init__.py +112 -112
  158. tapps_agents/context7/agent_integration.py +869 -869
  159. tapps_agents/context7/analytics.py +382 -382
  160. tapps_agents/context7/analytics_dashboard.py +299 -299
  161. tapps_agents/context7/async_cache.py +681 -681
  162. tapps_agents/context7/backup_client.py +958 -958
  163. tapps_agents/context7/cache_locking.py +194 -194
  164. tapps_agents/context7/cache_metadata.py +214 -214
  165. tapps_agents/context7/cache_prewarm.py +488 -488
  166. tapps_agents/context7/cache_structure.py +168 -168
  167. tapps_agents/context7/cache_warming.py +604 -604
  168. tapps_agents/context7/circuit_breaker.py +376 -376
  169. tapps_agents/context7/cleanup.py +461 -461
  170. tapps_agents/context7/commands.py +858 -858
  171. tapps_agents/context7/credential_validation.py +276 -276
  172. tapps_agents/context7/cross_reference_resolver.py +168 -168
  173. tapps_agents/context7/cross_references.py +424 -424
  174. tapps_agents/context7/doc_manager.py +225 -225
  175. tapps_agents/context7/fuzzy_matcher.py +369 -369
  176. tapps_agents/context7/kb_cache.py +404 -404
  177. tapps_agents/context7/language_detector.py +219 -219
  178. tapps_agents/context7/library_detector.py +725 -725
  179. tapps_agents/context7/lookup.py +738 -738
  180. tapps_agents/context7/metadata.py +258 -258
  181. tapps_agents/context7/refresh_queue.py +300 -300
  182. tapps_agents/context7/security.py +373 -373
  183. tapps_agents/context7/staleness_policies.py +278 -278
  184. tapps_agents/context7/tiles_integration.py +47 -47
  185. tapps_agents/continuous_bug_fix/__init__.py +20 -20
  186. tapps_agents/continuous_bug_fix/bug_finder.py +306 -306
  187. tapps_agents/continuous_bug_fix/bug_fix_coordinator.py +177 -177
  188. tapps_agents/continuous_bug_fix/commit_manager.py +178 -178
  189. tapps_agents/continuous_bug_fix/continuous_bug_fixer.py +322 -322
  190. tapps_agents/continuous_bug_fix/proactive_bug_finder.py +285 -285
  191. tapps_agents/core/__init__.py +298 -298
  192. tapps_agents/core/adaptive_cache_config.py +432 -432
  193. tapps_agents/core/agent_base.py +647 -647
  194. tapps_agents/core/agent_cache.py +466 -466
  195. tapps_agents/core/agent_learning.py +1865 -1865
  196. tapps_agents/core/analytics_dashboard.py +563 -563
  197. tapps_agents/core/analytics_enhancements.py +597 -597
  198. tapps_agents/core/anonymization.py +274 -274
  199. tapps_agents/core/artifact_context_builder.py +293 -0
  200. tapps_agents/core/ast_parser.py +228 -228
  201. tapps_agents/core/async_file_ops.py +402 -402
  202. tapps_agents/core/best_practice_consultant.py +299 -299
  203. tapps_agents/core/brownfield_analyzer.py +299 -299
  204. tapps_agents/core/brownfield_review.py +541 -541
  205. tapps_agents/core/browser_controller.py +513 -513
  206. tapps_agents/core/capability_registry.py +418 -418
  207. tapps_agents/core/change_impact_analyzer.py +190 -190
  208. tapps_agents/core/checkpoint_manager.py +377 -377
  209. tapps_agents/core/code_generator.py +329 -329
  210. tapps_agents/core/code_validator.py +276 -276
  211. tapps_agents/core/command_registry.py +327 -327
  212. tapps_agents/core/config.py +33 -0
  213. tapps_agents/core/context_gathering/__init__.py +2 -2
  214. tapps_agents/core/context_gathering/repository_explorer.py +28 -28
  215. tapps_agents/core/context_intelligence/__init__.py +2 -2
  216. tapps_agents/core/context_intelligence/relevance_scorer.py +24 -24
  217. tapps_agents/core/context_intelligence/token_budget_manager.py +27 -27
  218. tapps_agents/core/context_manager.py +240 -240
  219. tapps_agents/core/cursor_feedback_monitor.py +146 -146
  220. tapps_agents/core/cursor_verification.py +290 -290
  221. tapps_agents/core/customization_loader.py +280 -280
  222. tapps_agents/core/customization_schema.py +260 -260
  223. tapps_agents/core/customization_template.py +238 -238
  224. tapps_agents/core/debug_logger.py +124 -124
  225. tapps_agents/core/design_validator.py +298 -298
  226. tapps_agents/core/diagram_generator.py +226 -226
  227. tapps_agents/core/docker_utils.py +232 -232
  228. tapps_agents/core/document_generator.py +617 -617
  229. tapps_agents/core/domain_detector.py +30 -30
  230. tapps_agents/core/error_envelope.py +454 -454
  231. tapps_agents/core/error_handler.py +270 -270
  232. tapps_agents/core/estimation_tracker.py +189 -189
  233. tapps_agents/core/eval_prompt_engine.py +116 -116
  234. tapps_agents/core/evaluation_base.py +119 -119
  235. tapps_agents/core/evaluation_models.py +320 -320
  236. tapps_agents/core/evaluation_orchestrator.py +225 -225
  237. tapps_agents/core/evaluators/__init__.py +7 -7
  238. tapps_agents/core/evaluators/architectural_evaluator.py +205 -205
  239. tapps_agents/core/evaluators/behavioral_evaluator.py +160 -160
  240. tapps_agents/core/evaluators/performance_profile_evaluator.py +160 -160
  241. tapps_agents/core/evaluators/security_posture_evaluator.py +148 -148
  242. tapps_agents/core/evaluators/spec_compliance_evaluator.py +181 -181
  243. tapps_agents/core/exceptions.py +107 -107
  244. tapps_agents/core/expert_config_generator.py +293 -293
  245. tapps_agents/core/export_schema.py +202 -202
  246. tapps_agents/core/external_feedback_models.py +102 -102
  247. tapps_agents/core/external_feedback_storage.py +213 -213
  248. tapps_agents/core/fallback_strategy.py +314 -314
  249. tapps_agents/core/feedback_analyzer.py +162 -162
  250. tapps_agents/core/feedback_collector.py +178 -178
  251. tapps_agents/core/git_operations.py +445 -445
  252. tapps_agents/core/hardware_profiler.py +151 -151
  253. tapps_agents/core/instructions.py +324 -324
  254. tapps_agents/core/io_guardrails.py +69 -69
  255. tapps_agents/core/issue_manifest.py +249 -249
  256. tapps_agents/core/issue_schema.py +139 -139
  257. tapps_agents/core/json_utils.py +128 -128
  258. tapps_agents/core/knowledge_graph.py +446 -446
  259. tapps_agents/core/language_detector.py +296 -296
  260. tapps_agents/core/learning_confidence.py +242 -242
  261. tapps_agents/core/learning_dashboard.py +246 -246
  262. tapps_agents/core/learning_decision.py +384 -384
  263. tapps_agents/core/learning_explainability.py +578 -578
  264. tapps_agents/core/learning_export.py +287 -287
  265. tapps_agents/core/learning_integration.py +228 -228
  266. tapps_agents/core/llm_behavior.py +232 -232
  267. tapps_agents/core/long_duration_support.py +786 -786
  268. tapps_agents/core/mcp_setup.py +106 -106
  269. tapps_agents/core/memory_integration.py +396 -396
  270. tapps_agents/core/meta_learning.py +666 -666
  271. tapps_agents/core/module_path_sanitizer.py +199 -199
  272. tapps_agents/core/multi_agent_orchestrator.py +382 -382
  273. tapps_agents/core/network_errors.py +125 -125
  274. tapps_agents/core/nfr_validator.py +336 -336
  275. tapps_agents/core/offline_mode.py +158 -158
  276. tapps_agents/core/output_contracts.py +300 -300
  277. tapps_agents/core/output_formatter.py +300 -300
  278. tapps_agents/core/path_normalizer.py +174 -174
  279. tapps_agents/core/path_validator.py +322 -322
  280. tapps_agents/core/pattern_library.py +250 -250
  281. tapps_agents/core/performance_benchmark.py +301 -301
  282. tapps_agents/core/performance_monitor.py +184 -184
  283. tapps_agents/core/playwright_mcp_controller.py +771 -771
  284. tapps_agents/core/policy_loader.py +135 -135
  285. tapps_agents/core/progress.py +166 -166
  286. tapps_agents/core/project_profile.py +354 -354
  287. tapps_agents/core/project_type_detector.py +454 -454
  288. tapps_agents/core/prompt_base.py +223 -223
  289. tapps_agents/core/prompt_learning/__init__.py +2 -2
  290. tapps_agents/core/prompt_learning/learning_loop.py +24 -24
  291. tapps_agents/core/prompt_learning/project_prompt_store.py +25 -25
  292. tapps_agents/core/prompt_learning/skills_prompt_analyzer.py +35 -35
  293. tapps_agents/core/prompt_optimization/__init__.py +6 -6
  294. tapps_agents/core/prompt_optimization/ab_tester.py +114 -114
  295. tapps_agents/core/prompt_optimization/correlation_analyzer.py +160 -160
  296. tapps_agents/core/prompt_optimization/progressive_refiner.py +129 -129
  297. tapps_agents/core/prompt_optimization/prompt_library.py +37 -37
  298. tapps_agents/core/requirements_evaluator.py +431 -431
  299. tapps_agents/core/resource_aware_executor.py +449 -449
  300. tapps_agents/core/resource_monitor.py +343 -343
  301. tapps_agents/core/resume_handler.py +298 -298
  302. tapps_agents/core/retry_handler.py +197 -197
  303. tapps_agents/core/review_checklists.py +479 -479
  304. tapps_agents/core/role_loader.py +201 -201
  305. tapps_agents/core/role_template_loader.py +201 -201
  306. tapps_agents/core/runtime_mode.py +60 -60
  307. tapps_agents/core/security_scanner.py +342 -342
  308. tapps_agents/core/skill_agent_registry.py +194 -194
  309. tapps_agents/core/skill_integration.py +208 -208
  310. tapps_agents/core/skill_loader.py +492 -492
  311. tapps_agents/core/skill_template.py +341 -341
  312. tapps_agents/core/skill_validator.py +478 -478
  313. tapps_agents/core/stack_analyzer.py +35 -35
  314. tapps_agents/core/startup.py +174 -174
  315. tapps_agents/core/storage_manager.py +397 -397
  316. tapps_agents/core/storage_models.py +166 -166
  317. tapps_agents/core/story_evaluator.py +410 -410
  318. tapps_agents/core/subprocess_utils.py +170 -170
  319. tapps_agents/core/task_duration.py +296 -296
  320. tapps_agents/core/task_memory.py +582 -582
  321. tapps_agents/core/task_state.py +226 -226
  322. tapps_agents/core/tech_stack_priorities.py +208 -208
  323. tapps_agents/core/temp_directory.py +194 -194
  324. tapps_agents/core/template_merger.py +600 -600
  325. tapps_agents/core/template_selector.py +280 -280
  326. tapps_agents/core/test_generator.py +286 -286
  327. tapps_agents/core/tiered_context.py +253 -253
  328. tapps_agents/core/token_monitor.py +345 -345
  329. tapps_agents/core/traceability.py +254 -254
  330. tapps_agents/core/trajectory_tracker.py +50 -50
  331. tapps_agents/core/unicode_safe.py +143 -143
  332. tapps_agents/core/unified_cache_config.py +170 -170
  333. tapps_agents/core/unified_state.py +324 -324
  334. tapps_agents/core/validate_cursor_setup.py +237 -237
  335. tapps_agents/core/validation_registry.py +136 -136
  336. tapps_agents/core/validators/__init__.py +4 -4
  337. tapps_agents/core/validators/python_validator.py +87 -87
  338. tapps_agents/core/verification_agent.py +90 -90
  339. tapps_agents/core/visual_feedback.py +644 -644
  340. tapps_agents/core/workflow_validator.py +197 -197
  341. tapps_agents/core/worktree.py +367 -367
  342. tapps_agents/docker/__init__.py +10 -10
  343. tapps_agents/docker/analyzer.py +186 -186
  344. tapps_agents/docker/debugger.py +229 -229
  345. tapps_agents/docker/error_patterns.py +216 -216
  346. tapps_agents/epic/__init__.py +22 -22
  347. tapps_agents/epic/beads_sync.py +115 -115
  348. tapps_agents/epic/markdown_sync.py +105 -105
  349. tapps_agents/epic/models.py +96 -96
  350. tapps_agents/experts/__init__.py +163 -163
  351. tapps_agents/experts/agent_integration.py +243 -243
  352. tapps_agents/experts/auto_generator.py +331 -331
  353. tapps_agents/experts/base_expert.py +536 -536
  354. tapps_agents/experts/builtin_registry.py +261 -261
  355. tapps_agents/experts/business_metrics.py +565 -565
  356. tapps_agents/experts/cache.py +266 -266
  357. tapps_agents/experts/confidence_breakdown.py +306 -306
  358. tapps_agents/experts/confidence_calculator.py +336 -336
  359. tapps_agents/experts/confidence_metrics.py +236 -236
  360. tapps_agents/experts/domain_config.py +311 -311
  361. tapps_agents/experts/domain_detector.py +550 -550
  362. tapps_agents/experts/domain_utils.py +84 -84
  363. tapps_agents/experts/expert_config.py +113 -113
  364. tapps_agents/experts/expert_engine.py +465 -465
  365. tapps_agents/experts/expert_registry.py +744 -744
  366. tapps_agents/experts/expert_synthesizer.py +70 -70
  367. tapps_agents/experts/governance.py +197 -197
  368. tapps_agents/experts/history_logger.py +312 -312
  369. tapps_agents/experts/knowledge/README.md +180 -180
  370. tapps_agents/experts/knowledge/accessibility/accessible-forms.md +331 -331
  371. tapps_agents/experts/knowledge/accessibility/aria-patterns.md +344 -344
  372. tapps_agents/experts/knowledge/accessibility/color-contrast.md +285 -285
  373. tapps_agents/experts/knowledge/accessibility/keyboard-navigation.md +332 -332
  374. tapps_agents/experts/knowledge/accessibility/screen-readers.md +282 -282
  375. tapps_agents/experts/knowledge/accessibility/semantic-html.md +355 -355
  376. tapps_agents/experts/knowledge/accessibility/testing-accessibility.md +369 -369
  377. tapps_agents/experts/knowledge/accessibility/wcag-2.1.md +296 -296
  378. tapps_agents/experts/knowledge/accessibility/wcag-2.2.md +211 -211
  379. tapps_agents/experts/knowledge/agent-learning/best-practices.md +715 -715
  380. tapps_agents/experts/knowledge/agent-learning/pattern-extraction.md +282 -282
  381. tapps_agents/experts/knowledge/agent-learning/prompt-optimization.md +320 -320
  382. tapps_agents/experts/knowledge/ai-frameworks/model-optimization.md +90 -90
  383. tapps_agents/experts/knowledge/ai-frameworks/openvino-patterns.md +260 -260
  384. tapps_agents/experts/knowledge/api-design-integration/api-gateway-patterns.md +309 -309
  385. tapps_agents/experts/knowledge/api-design-integration/api-security-patterns.md +521 -521
  386. tapps_agents/experts/knowledge/api-design-integration/api-versioning.md +421 -421
  387. tapps_agents/experts/knowledge/api-design-integration/async-protocol-patterns.md +61 -61
  388. tapps_agents/experts/knowledge/api-design-integration/contract-testing.md +221 -221
  389. tapps_agents/experts/knowledge/api-design-integration/external-api-integration.md +489 -489
  390. tapps_agents/experts/knowledge/api-design-integration/fastapi-patterns.md +360 -360
  391. tapps_agents/experts/knowledge/api-design-integration/fastapi-testing.md +262 -262
  392. tapps_agents/experts/knowledge/api-design-integration/graphql-patterns.md +582 -582
  393. tapps_agents/experts/knowledge/api-design-integration/grpc-best-practices.md +499 -499
  394. tapps_agents/experts/knowledge/api-design-integration/mqtt-patterns.md +455 -455
  395. tapps_agents/experts/knowledge/api-design-integration/rate-limiting.md +507 -507
  396. tapps_agents/experts/knowledge/api-design-integration/restful-api-design.md +618 -618
  397. tapps_agents/experts/knowledge/api-design-integration/websocket-patterns.md +480 -480
  398. tapps_agents/experts/knowledge/cloud-infrastructure/cloud-native-patterns.md +175 -175
  399. tapps_agents/experts/knowledge/cloud-infrastructure/container-health-checks.md +261 -261
  400. tapps_agents/experts/knowledge/cloud-infrastructure/containerization.md +222 -222
  401. tapps_agents/experts/knowledge/cloud-infrastructure/cost-optimization.md +122 -122
  402. tapps_agents/experts/knowledge/cloud-infrastructure/disaster-recovery.md +153 -153
  403. tapps_agents/experts/knowledge/cloud-infrastructure/dockerfile-patterns.md +285 -285
  404. tapps_agents/experts/knowledge/cloud-infrastructure/infrastructure-as-code.md +187 -187
  405. tapps_agents/experts/knowledge/cloud-infrastructure/kubernetes-patterns.md +253 -253
  406. tapps_agents/experts/knowledge/cloud-infrastructure/multi-cloud-strategies.md +155 -155
  407. tapps_agents/experts/knowledge/cloud-infrastructure/serverless-architecture.md +200 -200
  408. tapps_agents/experts/knowledge/code-quality-analysis/README.md +16 -16
  409. tapps_agents/experts/knowledge/code-quality-analysis/code-metrics.md +137 -137
  410. tapps_agents/experts/knowledge/code-quality-analysis/complexity-analysis.md +181 -181
  411. tapps_agents/experts/knowledge/code-quality-analysis/technical-debt-patterns.md +191 -191
  412. tapps_agents/experts/knowledge/data-privacy-compliance/anonymization.md +313 -313
  413. tapps_agents/experts/knowledge/data-privacy-compliance/ccpa.md +255 -255
  414. tapps_agents/experts/knowledge/data-privacy-compliance/consent-management.md +282 -282
  415. tapps_agents/experts/knowledge/data-privacy-compliance/data-minimization.md +275 -275
  416. tapps_agents/experts/knowledge/data-privacy-compliance/data-retention.md +297 -297
  417. tapps_agents/experts/knowledge/data-privacy-compliance/data-subject-rights.md +383 -383
  418. tapps_agents/experts/knowledge/data-privacy-compliance/encryption-privacy.md +285 -285
  419. tapps_agents/experts/knowledge/data-privacy-compliance/gdpr.md +344 -344
  420. tapps_agents/experts/knowledge/data-privacy-compliance/hipaa.md +385 -385
  421. tapps_agents/experts/knowledge/data-privacy-compliance/privacy-by-design.md +280 -280
  422. tapps_agents/experts/knowledge/database-data-management/acid-vs-cap.md +164 -164
  423. tapps_agents/experts/knowledge/database-data-management/backup-and-recovery.md +182 -182
  424. tapps_agents/experts/knowledge/database-data-management/data-modeling.md +172 -172
  425. tapps_agents/experts/knowledge/database-data-management/database-design.md +187 -187
  426. tapps_agents/experts/knowledge/database-data-management/flux-query-optimization.md +342 -342
  427. tapps_agents/experts/knowledge/database-data-management/influxdb-connection-patterns.md +432 -432
  428. tapps_agents/experts/knowledge/database-data-management/influxdb-patterns.md +442 -442
  429. tapps_agents/experts/knowledge/database-data-management/migration-strategies.md +216 -216
  430. tapps_agents/experts/knowledge/database-data-management/nosql-patterns.md +259 -259
  431. tapps_agents/experts/knowledge/database-data-management/scalability-patterns.md +184 -184
  432. tapps_agents/experts/knowledge/database-data-management/sql-optimization.md +175 -175
  433. tapps_agents/experts/knowledge/database-data-management/time-series-modeling.md +444 -444
  434. tapps_agents/experts/knowledge/development-workflow/README.md +16 -16
  435. tapps_agents/experts/knowledge/development-workflow/automation-best-practices.md +216 -216
  436. tapps_agents/experts/knowledge/development-workflow/build-strategies.md +198 -198
  437. tapps_agents/experts/knowledge/development-workflow/deployment-patterns.md +205 -205
  438. tapps_agents/experts/knowledge/development-workflow/git-workflows.md +205 -205
  439. tapps_agents/experts/knowledge/documentation-knowledge-management/README.md +16 -16
  440. tapps_agents/experts/knowledge/documentation-knowledge-management/api-documentation-patterns.md +231 -231
  441. tapps_agents/experts/knowledge/documentation-knowledge-management/documentation-standards.md +191 -191
  442. tapps_agents/experts/knowledge/documentation-knowledge-management/knowledge-management.md +171 -171
  443. tapps_agents/experts/knowledge/documentation-knowledge-management/technical-writing-guide.md +192 -192
  444. tapps_agents/experts/knowledge/observability-monitoring/alerting-patterns.md +461 -461
  445. tapps_agents/experts/knowledge/observability-monitoring/apm-tools.md +459 -459
  446. tapps_agents/experts/knowledge/observability-monitoring/distributed-tracing.md +367 -367
  447. tapps_agents/experts/knowledge/observability-monitoring/logging-strategies.md +478 -478
  448. tapps_agents/experts/knowledge/observability-monitoring/metrics-and-monitoring.md +510 -510
  449. tapps_agents/experts/knowledge/observability-monitoring/observability-best-practices.md +492 -492
  450. tapps_agents/experts/knowledge/observability-monitoring/open-telemetry.md +573 -573
  451. tapps_agents/experts/knowledge/observability-monitoring/slo-sli-sla.md +419 -419
  452. tapps_agents/experts/knowledge/performance/anti-patterns.md +284 -284
  453. tapps_agents/experts/knowledge/performance/api-performance.md +256 -256
  454. tapps_agents/experts/knowledge/performance/caching.md +327 -327
  455. tapps_agents/experts/knowledge/performance/database-performance.md +252 -252
  456. tapps_agents/experts/knowledge/performance/optimization-patterns.md +327 -327
  457. tapps_agents/experts/knowledge/performance/profiling.md +297 -297
  458. tapps_agents/experts/knowledge/performance/resource-management.md +293 -293
  459. tapps_agents/experts/knowledge/performance/scalability.md +306 -306
  460. tapps_agents/experts/knowledge/security/owasp-top10.md +209 -209
  461. tapps_agents/experts/knowledge/security/secure-coding-practices.md +207 -207
  462. tapps_agents/experts/knowledge/security/threat-modeling.md +220 -220
  463. tapps_agents/experts/knowledge/security/vulnerability-patterns.md +342 -342
  464. tapps_agents/experts/knowledge/software-architecture/docker-compose-patterns.md +314 -314
  465. tapps_agents/experts/knowledge/software-architecture/microservices-patterns.md +379 -379
  466. tapps_agents/experts/knowledge/software-architecture/service-communication.md +316 -316
  467. tapps_agents/experts/knowledge/testing/best-practices.md +310 -310
  468. tapps_agents/experts/knowledge/testing/coverage-analysis.md +293 -293
  469. tapps_agents/experts/knowledge/testing/mocking.md +256 -256
  470. tapps_agents/experts/knowledge/testing/test-automation.md +276 -276
  471. tapps_agents/experts/knowledge/testing/test-data.md +271 -271
  472. tapps_agents/experts/knowledge/testing/test-design-patterns.md +280 -280
  473. tapps_agents/experts/knowledge/testing/test-maintenance.md +236 -236
  474. tapps_agents/experts/knowledge/testing/test-strategies.md +311 -311
  475. tapps_agents/experts/knowledge/user-experience/information-architecture.md +325 -325
  476. tapps_agents/experts/knowledge/user-experience/interaction-design.md +363 -363
  477. tapps_agents/experts/knowledge/user-experience/prototyping.md +293 -293
  478. tapps_agents/experts/knowledge/user-experience/usability-heuristics.md +337 -337
  479. tapps_agents/experts/knowledge/user-experience/usability-testing.md +311 -311
  480. tapps_agents/experts/knowledge/user-experience/user-journeys.md +296 -296
  481. tapps_agents/experts/knowledge/user-experience/user-research.md +373 -373
  482. tapps_agents/experts/knowledge/user-experience/ux-principles.md +340 -340
  483. tapps_agents/experts/knowledge_freshness.py +321 -321
  484. tapps_agents/experts/knowledge_ingestion.py +438 -438
  485. tapps_agents/experts/knowledge_need_detector.py +93 -93
  486. tapps_agents/experts/knowledge_validator.py +382 -382
  487. tapps_agents/experts/observability.py +440 -440
  488. tapps_agents/experts/passive_notifier.py +238 -238
  489. tapps_agents/experts/proactive_orchestrator.py +32 -32
  490. tapps_agents/experts/rag_chunker.py +205 -205
  491. tapps_agents/experts/rag_embedder.py +152 -152
  492. tapps_agents/experts/rag_evaluation.py +299 -299
  493. tapps_agents/experts/rag_index.py +303 -303
  494. tapps_agents/experts/rag_metrics.py +293 -293
  495. tapps_agents/experts/rag_safety.py +263 -263
  496. tapps_agents/experts/report_generator.py +296 -296
  497. tapps_agents/experts/setup_wizard.py +441 -441
  498. tapps_agents/experts/simple_rag.py +431 -431
  499. tapps_agents/experts/vector_rag.py +354 -354
  500. tapps_agents/experts/weight_distributor.py +304 -304
  501. tapps_agents/health/__init__.py +24 -24
  502. tapps_agents/health/base.py +75 -75
  503. tapps_agents/health/checks/__init__.py +22 -22
  504. tapps_agents/health/checks/automation.py +127 -127
  505. tapps_agents/health/checks/context7_cache.py +210 -210
  506. tapps_agents/health/checks/environment.py +116 -116
  507. tapps_agents/health/checks/execution.py +170 -170
  508. tapps_agents/health/checks/knowledge_base.py +187 -187
  509. tapps_agents/health/checks/outcomes.py +324 -324
  510. tapps_agents/health/collector.py +280 -280
  511. tapps_agents/health/dashboard.py +137 -137
  512. tapps_agents/health/metrics.py +151 -151
  513. tapps_agents/health/orchestrator.py +271 -271
  514. tapps_agents/health/registry.py +166 -166
  515. tapps_agents/hooks/__init__.py +33 -33
  516. tapps_agents/hooks/config.py +140 -140
  517. tapps_agents/hooks/events.py +135 -135
  518. tapps_agents/hooks/executor.py +128 -128
  519. tapps_agents/hooks/manager.py +143 -143
  520. tapps_agents/integration/__init__.py +8 -8
  521. tapps_agents/integration/service_integrator.py +121 -121
  522. tapps_agents/integrations/__init__.py +10 -10
  523. tapps_agents/integrations/clawdbot.py +525 -525
  524. tapps_agents/integrations/memory_bridge.py +356 -356
  525. tapps_agents/mcp/__init__.py +18 -18
  526. tapps_agents/mcp/gateway.py +112 -112
  527. tapps_agents/mcp/servers/__init__.py +13 -13
  528. tapps_agents/mcp/servers/analysis.py +204 -204
  529. tapps_agents/mcp/servers/context7.py +198 -198
  530. tapps_agents/mcp/servers/filesystem.py +218 -218
  531. tapps_agents/mcp/servers/git.py +201 -201
  532. tapps_agents/mcp/tool_registry.py +115 -115
  533. tapps_agents/quality/__init__.py +54 -54
  534. tapps_agents/quality/coverage_analyzer.py +379 -379
  535. tapps_agents/quality/enforcement.py +82 -82
  536. tapps_agents/quality/gates/__init__.py +37 -37
  537. tapps_agents/quality/gates/approval_gate.py +255 -255
  538. tapps_agents/quality/gates/base.py +84 -84
  539. tapps_agents/quality/gates/exceptions.py +43 -43
  540. tapps_agents/quality/gates/policy_gate.py +195 -195
  541. tapps_agents/quality/gates/registry.py +239 -239
  542. tapps_agents/quality/gates/security_gate.py +156 -156
  543. tapps_agents/quality/quality_gates.py +369 -369
  544. tapps_agents/quality/secret_scanner.py +335 -335
  545. tapps_agents/session/__init__.py +19 -19
  546. tapps_agents/session/manager.py +256 -256
  547. tapps_agents/simple_mode/__init__.py +66 -66
  548. tapps_agents/simple_mode/agent_contracts.py +357 -357
  549. tapps_agents/simple_mode/beads_hooks.py +151 -151
  550. tapps_agents/simple_mode/code_snippet_handler.py +382 -382
  551. tapps_agents/simple_mode/documentation_manager.py +395 -395
  552. tapps_agents/simple_mode/documentation_reader.py +187 -187
  553. tapps_agents/simple_mode/file_inference.py +292 -292
  554. tapps_agents/simple_mode/framework_change_detector.py +268 -268
  555. tapps_agents/simple_mode/intent_parser.py +510 -510
  556. tapps_agents/simple_mode/learning_progression.py +358 -358
  557. tapps_agents/simple_mode/nl_handler.py +700 -700
  558. tapps_agents/simple_mode/onboarding.py +253 -253
  559. tapps_agents/simple_mode/orchestrators/__init__.py +38 -38
  560. tapps_agents/simple_mode/orchestrators/base.py +185 -185
  561. tapps_agents/simple_mode/orchestrators/breakdown_orchestrator.py +49 -49
  562. tapps_agents/simple_mode/orchestrators/brownfield_orchestrator.py +135 -135
  563. tapps_agents/simple_mode/orchestrators/build_orchestrator.py +2700 -2667
  564. tapps_agents/simple_mode/orchestrators/deliverable_checklist.py +349 -349
  565. tapps_agents/simple_mode/orchestrators/enhance_orchestrator.py +53 -53
  566. tapps_agents/simple_mode/orchestrators/epic_orchestrator.py +122 -122
  567. tapps_agents/simple_mode/orchestrators/explore_orchestrator.py +184 -184
  568. tapps_agents/simple_mode/orchestrators/fix_orchestrator.py +723 -723
  569. tapps_agents/simple_mode/orchestrators/plan_analysis_orchestrator.py +206 -206
  570. tapps_agents/simple_mode/orchestrators/pr_orchestrator.py +237 -237
  571. tapps_agents/simple_mode/orchestrators/refactor_orchestrator.py +222 -222
  572. tapps_agents/simple_mode/orchestrators/requirements_tracer.py +262 -262
  573. tapps_agents/simple_mode/orchestrators/resume_orchestrator.py +210 -210
  574. tapps_agents/simple_mode/orchestrators/review_orchestrator.py +161 -161
  575. tapps_agents/simple_mode/orchestrators/test_orchestrator.py +82 -82
  576. tapps_agents/simple_mode/output_aggregator.py +340 -340
  577. tapps_agents/simple_mode/result_formatters.py +598 -598
  578. tapps_agents/simple_mode/step_dependencies.py +382 -382
  579. tapps_agents/simple_mode/step_results.py +276 -276
  580. tapps_agents/simple_mode/streaming.py +388 -388
  581. tapps_agents/simple_mode/variations.py +129 -129
  582. tapps_agents/simple_mode/visual_feedback.py +238 -238
  583. tapps_agents/simple_mode/zero_config.py +274 -274
  584. tapps_agents/suggestions/__init__.py +8 -8
  585. tapps_agents/suggestions/inline_suggester.py +52 -52
  586. tapps_agents/templates/__init__.py +8 -8
  587. tapps_agents/templates/microservice_generator.py +274 -274
  588. tapps_agents/utils/env_validator.py +291 -291
  589. tapps_agents/workflow/__init__.py +171 -171
  590. tapps_agents/workflow/acceptance_verifier.py +132 -132
  591. tapps_agents/workflow/agent_handlers/__init__.py +41 -41
  592. tapps_agents/workflow/agent_handlers/analyst_handler.py +75 -75
  593. tapps_agents/workflow/agent_handlers/architect_handler.py +107 -107
  594. tapps_agents/workflow/agent_handlers/base.py +84 -84
  595. tapps_agents/workflow/agent_handlers/debugger_handler.py +100 -100
  596. tapps_agents/workflow/agent_handlers/designer_handler.py +110 -110
  597. tapps_agents/workflow/agent_handlers/documenter_handler.py +94 -94
  598. tapps_agents/workflow/agent_handlers/implementer_handler.py +235 -235
  599. tapps_agents/workflow/agent_handlers/ops_handler.py +62 -62
  600. tapps_agents/workflow/agent_handlers/orchestrator_handler.py +43 -43
  601. tapps_agents/workflow/agent_handlers/planner_handler.py +98 -98
  602. tapps_agents/workflow/agent_handlers/registry.py +119 -119
  603. tapps_agents/workflow/agent_handlers/reviewer_handler.py +119 -119
  604. tapps_agents/workflow/agent_handlers/tester_handler.py +69 -69
  605. tapps_agents/workflow/analytics_accessor.py +337 -337
  606. tapps_agents/workflow/analytics_alerts.py +416 -416
  607. tapps_agents/workflow/analytics_dashboard_cursor.py +281 -281
  608. tapps_agents/workflow/analytics_dual_write.py +103 -103
  609. tapps_agents/workflow/analytics_integration.py +119 -119
  610. tapps_agents/workflow/analytics_query_parser.py +278 -278
  611. tapps_agents/workflow/analytics_visualizer.py +259 -259
  612. tapps_agents/workflow/artifact_helper.py +204 -204
  613. tapps_agents/workflow/audit_logger.py +263 -263
  614. tapps_agents/workflow/auto_execution_config.py +340 -340
  615. tapps_agents/workflow/auto_progression.py +586 -586
  616. tapps_agents/workflow/branch_cleanup.py +349 -349
  617. tapps_agents/workflow/checkpoint.py +256 -256
  618. tapps_agents/workflow/checkpoint_manager.py +178 -178
  619. tapps_agents/workflow/code_artifact.py +179 -179
  620. tapps_agents/workflow/common_enums.py +96 -96
  621. tapps_agents/workflow/confirmation_handler.py +130 -130
  622. tapps_agents/workflow/context_analyzer.py +222 -222
  623. tapps_agents/workflow/context_artifact.py +230 -230
  624. tapps_agents/workflow/cursor_chat.py +94 -94
  625. tapps_agents/workflow/cursor_executor.py +2337 -2196
  626. tapps_agents/workflow/cursor_skill_helper.py +516 -516
  627. tapps_agents/workflow/dependency_resolver.py +244 -244
  628. tapps_agents/workflow/design_artifact.py +156 -156
  629. tapps_agents/workflow/detector.py +751 -751
  630. tapps_agents/workflow/direct_execution_fallback.py +301 -301
  631. tapps_agents/workflow/docs_artifact.py +168 -168
  632. tapps_agents/workflow/enforcer.py +389 -389
  633. tapps_agents/workflow/enhancement_artifact.py +142 -142
  634. tapps_agents/workflow/error_recovery.py +806 -806
  635. tapps_agents/workflow/event_bus.py +183 -183
  636. tapps_agents/workflow/event_log.py +612 -612
  637. tapps_agents/workflow/events.py +63 -63
  638. tapps_agents/workflow/exceptions.py +43 -43
  639. tapps_agents/workflow/execution_graph.py +498 -498
  640. tapps_agents/workflow/execution_plan.py +126 -126
  641. tapps_agents/workflow/file_utils.py +186 -186
  642. tapps_agents/workflow/gate_evaluator.py +182 -182
  643. tapps_agents/workflow/gate_integration.py +200 -200
  644. tapps_agents/workflow/graph_visualizer.py +130 -130
  645. tapps_agents/workflow/health_checker.py +206 -206
  646. tapps_agents/workflow/logging_helper.py +243 -243
  647. tapps_agents/workflow/manifest.py +582 -582
  648. tapps_agents/workflow/marker_writer.py +250 -250
  649. tapps_agents/workflow/message_formatter.py +188 -188
  650. tapps_agents/workflow/messaging.py +325 -325
  651. tapps_agents/workflow/metadata_models.py +91 -91
  652. tapps_agents/workflow/metrics_integration.py +226 -226
  653. tapps_agents/workflow/migration_utils.py +116 -116
  654. tapps_agents/workflow/models.py +148 -111
  655. tapps_agents/workflow/nlp_config.py +198 -198
  656. tapps_agents/workflow/nlp_error_handler.py +207 -207
  657. tapps_agents/workflow/nlp_executor.py +163 -163
  658. tapps_agents/workflow/nlp_parser.py +528 -528
  659. tapps_agents/workflow/observability_dashboard.py +451 -451
  660. tapps_agents/workflow/observer.py +170 -170
  661. tapps_agents/workflow/ops_artifact.py +257 -257
  662. tapps_agents/workflow/output_passing.py +214 -214
  663. tapps_agents/workflow/parallel_executor.py +463 -463
  664. tapps_agents/workflow/planning_artifact.py +179 -179
  665. tapps_agents/workflow/preset_loader.py +285 -285
  666. tapps_agents/workflow/preset_recommender.py +270 -270
  667. tapps_agents/workflow/progress_logger.py +145 -145
  668. tapps_agents/workflow/progress_manager.py +303 -303
  669. tapps_agents/workflow/progress_monitor.py +186 -186
  670. tapps_agents/workflow/progress_updates.py +423 -423
  671. tapps_agents/workflow/quality_artifact.py +158 -158
  672. tapps_agents/workflow/quality_loopback.py +101 -101
  673. tapps_agents/workflow/recommender.py +387 -387
  674. tapps_agents/workflow/remediation_loop.py +166 -166
  675. tapps_agents/workflow/result_aggregator.py +300 -300
  676. tapps_agents/workflow/review_artifact.py +185 -185
  677. tapps_agents/workflow/schema_validator.py +522 -522
  678. tapps_agents/workflow/session_handoff.py +178 -178
  679. tapps_agents/workflow/skill_invoker.py +648 -648
  680. tapps_agents/workflow/state_manager.py +756 -756
  681. tapps_agents/workflow/state_persistence_config.py +331 -331
  682. tapps_agents/workflow/status_monitor.py +449 -449
  683. tapps_agents/workflow/step_checkpoint.py +314 -314
  684. tapps_agents/workflow/step_details.py +201 -201
  685. tapps_agents/workflow/story_models.py +147 -147
  686. tapps_agents/workflow/streaming.py +416 -416
  687. tapps_agents/workflow/suggestion_engine.py +552 -552
  688. tapps_agents/workflow/testing_artifact.py +186 -186
  689. tapps_agents/workflow/timeline.py +158 -158
  690. tapps_agents/workflow/token_integration.py +209 -209
  691. tapps_agents/workflow/validation.py +217 -217
  692. tapps_agents/workflow/visual_feedback.py +391 -391
  693. tapps_agents/workflow/workflow_chain.py +95 -95
  694. tapps_agents/workflow/workflow_summary.py +219 -219
  695. tapps_agents/workflow/worktree_manager.py +724 -724
  696. {tapps_agents-3.5.40.dist-info → tapps_agents-3.6.0.dist-info}/METADATA +672 -672
  697. tapps_agents-3.6.0.dist-info/RECORD +758 -0
  698. {tapps_agents-3.5.40.dist-info → tapps_agents-3.6.0.dist-info}/licenses/LICENSE +22 -22
  699. tapps_agents/health/checks/outcomes.backup_20260204_064058.py +0 -324
  700. tapps_agents/health/checks/outcomes.backup_20260204_064256.py +0 -324
  701. tapps_agents/health/checks/outcomes.backup_20260204_064600.py +0 -324
  702. tapps_agents-3.5.40.dist-info/RECORD +0 -760
  703. {tapps_agents-3.5.40.dist-info → tapps_agents-3.6.0.dist-info}/WHEEL +0 -0
  704. {tapps_agents-3.5.40.dist-info → tapps_agents-3.6.0.dist-info}/entry_points.txt +0 -0
  705. {tapps_agents-3.5.40.dist-info → tapps_agents-3.6.0.dist-info}/top_level.txt +0 -0
@@ -1,565 +1,565 @@
1
- """
2
- Business Metrics Collection for Experts Feature
3
-
4
- Collects and aggregates business metrics from technical metrics to demonstrate
5
- the business value and ROI of expert consultations.
6
-
7
- Phases:
8
- - Phase 1: Aggregate existing technical metrics into business metrics
9
- - Phase 2: Correlate expert consultations with code quality scores
10
- - Phase 3: Calculate ROI and track user value
11
- """
12
-
13
- from __future__ import annotations
14
-
15
- import json
16
- import logging
17
- from dataclasses import asdict, dataclass, field
18
- from datetime import datetime, timedelta
19
- from pathlib import Path
20
- from typing import Any
21
-
22
- from .confidence_metrics import ConfidenceMetricsTracker, get_tracker
23
- from .expert_engine import ExpertEngine, ExpertEngineMetrics
24
-
25
- logger = logging.getLogger(__name__)
26
-
27
-
28
- @dataclass
29
- class AdoptionMetrics:
30
- """Adoption and usage metrics."""
31
-
32
- total_consultations: int = 0
33
- consultations_per_workflow: float = 0.0
34
- consultations_per_day: float = 0.0
35
- expert_usage_by_id: dict[str, int] = field(default_factory=dict)
36
- domain_usage: dict[str, int] = field(default_factory=dict)
37
- agent_usage: dict[str, int] = field(default_factory=dict)
38
- workflow_usage_percentage: float = 0.0
39
-
40
-
41
- @dataclass
42
- class CodeQualityImprovement:
43
- """Single code quality improvement record."""
44
-
45
- consultation_id: str
46
- timestamp: datetime
47
- before_score: float
48
- after_score: float
49
- improvement_percentage: float
50
- expert_id: str
51
- domain: str
52
-
53
-
54
- @dataclass
55
- class EffectivenessMetrics:
56
- """Effectiveness and impact metrics."""
57
-
58
- code_quality_improvements: list[CodeQualityImprovement] = field(
59
- default_factory=list
60
- )
61
- avg_quality_improvement: float = 0.0
62
- bug_prevention_rate: float = 0.0
63
- avg_time_savings_minutes: float = 15.0 # Default estimate
64
- total_bugs_prevented: int = 0
65
-
66
-
67
- @dataclass
68
- class QualityMetrics:
69
- """Quality and performance metrics."""
70
-
71
- avg_confidence: float = 0.0
72
- confidence_trend: list[float] = field(default_factory=list)
73
- avg_agreement_level: float = 0.0
74
- rag_quality_score: float = 0.0
75
- cache_hit_rate: float = 0.0
76
- avg_latency_ms: float = 0.0
77
-
78
-
79
- @dataclass
80
- class ROIMetrics:
81
- """ROI and business value metrics."""
82
-
83
- total_consultations: int = 0
84
- estimated_time_saved_hours: float = 0.0
85
- estimated_cost_per_consultation: float = 0.01 # Infrastructure cost
86
- estimated_value_per_consultation: float = 0.0 # Time saved value
87
- total_cost: float = 0.0
88
- total_value: float = 0.0
89
- roi_percentage: float = 0.0
90
- roi_per_consultation: float = 0.0
91
-
92
-
93
- @dataclass
94
- class OperationalMetrics:
95
- """System health and operational metrics."""
96
-
97
- cache_hit_rate: float = 0.0
98
- context7_hit_rate: float = 0.0
99
- local_kb_hit_rate: float = 0.0
100
- avg_latency_ms: float = 0.0
101
- error_rate: float = 0.0
102
- knowledge_base_size: int = 0
103
-
104
-
105
- @dataclass
106
- class BusinessMetricsData:
107
- """Complete business metrics snapshot."""
108
-
109
- timestamp: datetime
110
- adoption_metrics: AdoptionMetrics
111
- effectiveness_metrics: EffectivenessMetrics
112
- quality_metrics: QualityMetrics
113
- roi_metrics: ROIMetrics
114
- operational_metrics: OperationalMetrics
115
-
116
- def to_dict(self) -> dict[str, Any]:
117
- """Convert to dictionary for JSON serialization."""
118
- data = asdict(self)
119
- # Convert datetime to ISO format string
120
- data["timestamp"] = self.timestamp.isoformat()
121
- # Convert CodeQualityImprovement datetimes
122
- for improvement in data["effectiveness_metrics"]["code_quality_improvements"]:
123
- if isinstance(improvement.get("timestamp"), datetime):
124
- improvement["timestamp"] = improvement["timestamp"].isoformat()
125
- return data
126
-
127
- @classmethod
128
- def from_dict(cls, data: dict[str, Any]) -> BusinessMetricsData:
129
- """Create from dictionary (from JSON)."""
130
- # Convert ISO format string back to datetime
131
- if isinstance(data.get("timestamp"), str):
132
- data["timestamp"] = datetime.fromisoformat(data["timestamp"])
133
-
134
- # Convert CodeQualityImprovement timestamps
135
- for improvement in data.get("effectiveness_metrics", {}).get(
136
- "code_quality_improvements", []
137
- ):
138
- if isinstance(improvement.get("timestamp"), str):
139
- improvement["timestamp"] = datetime.fromisoformat(
140
- improvement["timestamp"]
141
- )
142
-
143
- return cls(**data)
144
-
145
-
146
- class MetricsStorage:
147
- """File-based storage for business metrics."""
148
-
149
- def __init__(self, storage_path: Path | None = None):
150
- """
151
- Initialize metrics storage.
152
-
153
- Args:
154
- storage_path: Path to metrics directory (default: .tapps-agents/metrics)
155
- """
156
- if storage_path is None:
157
- storage_path = Path(".tapps-agents") / "metrics"
158
- self.storage_path = storage_path
159
- self.storage_path.mkdir(parents=True, exist_ok=True)
160
-
161
- self.current_metrics_file = self.storage_path / "business_metrics.json"
162
- self.history_file = self.storage_path / "business_metrics_history.json"
163
- self.correlations_file = self.storage_path / "correlations.json"
164
-
165
- def save_metrics(self, metrics: BusinessMetricsData) -> None:
166
- """Save metrics to JSON file."""
167
- try:
168
- # Save current snapshot
169
- with open(self.current_metrics_file, "w", encoding="utf-8") as f:
170
- json.dump(metrics.to_dict(), f, indent=2)
171
-
172
- # Append to history
173
- history = self._load_history()
174
- history.append(metrics.to_dict())
175
- with open(self.history_file, "w", encoding="utf-8") as f:
176
- json.dump(history, f, indent=2)
177
-
178
- logger.debug(f"Saved business metrics to {self.current_metrics_file}")
179
- except Exception as e:
180
- logger.error(f"Failed to save business metrics: {e}", exc_info=True)
181
-
182
- def load_current_metrics(self) -> BusinessMetricsData | None:
183
- """Load current metrics snapshot."""
184
- if not self.current_metrics_file.exists():
185
- return None
186
-
187
- try:
188
- with open(self.current_metrics_file, "r", encoding="utf-8") as f:
189
- data = json.load(f)
190
- return BusinessMetricsData.from_dict(data)
191
- except Exception as e:
192
- logger.error(f"Failed to load current metrics: {e}", exc_info=True)
193
- return None
194
-
195
- def load_historical_metrics(
196
- self,
197
- start_date: datetime | None = None,
198
- end_date: datetime | None = None,
199
- ) -> list[BusinessMetricsData]:
200
- """Load historical metrics for date range."""
201
- history = self._load_history()
202
- metrics_list = []
203
-
204
- for entry in history:
205
- try:
206
- metrics = BusinessMetricsData.from_dict(entry)
207
- timestamp = metrics.timestamp
208
-
209
- # Filter by date range
210
- if start_date and timestamp < start_date:
211
- continue
212
- if end_date and timestamp > end_date:
213
- continue
214
-
215
- metrics_list.append(metrics)
216
- except Exception as e:
217
- logger.warning(f"Failed to parse historical metric entry: {e}")
218
- continue
219
-
220
- return metrics_list
221
-
222
- def save_correlation(
223
- self, consultation_id: str, before_score: float, after_score: float
224
- ) -> None:
225
- """Save code quality correlation data."""
226
- correlations = self._load_correlations()
227
- correlations[consultation_id] = {
228
- "timestamp": datetime.now().isoformat(),
229
- "before_score": before_score,
230
- "after_score": after_score,
231
- "improvement": after_score - before_score,
232
- }
233
-
234
- try:
235
- with open(self.correlations_file, "w", encoding="utf-8") as f:
236
- json.dump(correlations, f, indent=2)
237
- except Exception as e:
238
- logger.error(f"Failed to save correlation: {e}", exc_info=True)
239
-
240
- def _load_history(self) -> list[dict[str, Any]]:
241
- """Load history file."""
242
- if not self.history_file.exists():
243
- return []
244
- try:
245
- with open(self.history_file, "r", encoding="utf-8") as f:
246
- return json.load(f)
247
- except Exception:
248
- return []
249
-
250
- def _load_correlations(self) -> dict[str, Any]:
251
- """Load correlations file."""
252
- if not self.correlations_file.exists():
253
- return {}
254
- try:
255
- with open(self.correlations_file, "r", encoding="utf-8") as f:
256
- return json.load(f)
257
- except Exception:
258
- return {}
259
-
260
-
261
- class BusinessMetricsCollector:
262
- """Collects and aggregates business metrics from technical metrics."""
263
-
264
- def __init__(
265
- self,
266
- expert_engine: ExpertEngine | None = None,
267
- confidence_tracker: ConfidenceMetricsTracker | None = None,
268
- storage_path: Path | None = None,
269
- time_savings_per_consultation_minutes: float = 15.0,
270
- cost_per_consultation: float = 0.01,
271
- ):
272
- """
273
- Initialize business metrics collector.
274
-
275
- Args:
276
- expert_engine: ExpertEngine instance (optional)
277
- confidence_tracker: ConfidenceMetricsTracker instance (optional)
278
- storage_path: Path to metrics storage directory
279
- time_savings_per_consultation_minutes: Estimated time saved per consultation
280
- cost_per_consultation: Estimated infrastructure cost per consultation
281
- """
282
- self.expert_engine = expert_engine
283
- self.confidence_tracker = confidence_tracker or get_tracker()
284
- self.storage = MetricsStorage(storage_path)
285
- self.time_savings_per_consultation_minutes = time_savings_per_consultation_minutes
286
- self.cost_per_consultation = cost_per_consultation
287
-
288
- async def collect_metrics(self) -> BusinessMetricsData:
289
- """Collect current business metrics from all sources."""
290
- # Aggregate adoption metrics
291
- adoption = self.aggregate_adoption_metrics()
292
-
293
- # Calculate effectiveness metrics
294
- effectiveness = self.calculate_effectiveness_metrics()
295
-
296
- # Aggregate quality metrics
297
- quality = self.aggregate_quality_metrics()
298
-
299
- # Calculate ROI metrics
300
- roi = self.calculate_roi_metrics(adoption.total_consultations)
301
-
302
- # Aggregate operational metrics
303
- operational = self.aggregate_operational_metrics()
304
-
305
- metrics = BusinessMetricsData(
306
- timestamp=datetime.now(),
307
- adoption_metrics=adoption,
308
- effectiveness_metrics=effectiveness,
309
- quality_metrics=quality,
310
- roi_metrics=roi,
311
- operational_metrics=operational,
312
- )
313
-
314
- # Save metrics
315
- self.storage.save_metrics(metrics)
316
-
317
- return metrics
318
-
319
- def aggregate_adoption_metrics(self) -> AdoptionMetrics:
320
- """Aggregate adoption metrics (usage, frequency, popularity)."""
321
- adoption = AdoptionMetrics()
322
-
323
- # Get metrics from confidence tracker
324
- if self.confidence_tracker:
325
- metrics = self.confidence_tracker.get_metrics()
326
- adoption.total_consultations = len(metrics)
327
-
328
- # Count by expert, domain, agent
329
- for metric in metrics:
330
- # Expert usage (from primary_expert or domain)
331
- expert_id = getattr(metric, "primary_expert", None) or metric.domain
332
- adoption.expert_usage_by_id[expert_id] = (
333
- adoption.expert_usage_by_id.get(expert_id, 0) + 1
334
- )
335
-
336
- # Domain usage
337
- adoption.domain_usage[metric.domain] = (
338
- adoption.domain_usage.get(metric.domain, 0) + 1
339
- )
340
-
341
- # Agent usage
342
- adoption.agent_usage[metric.agent_id] = (
343
- adoption.agent_usage.get(metric.agent_id, 0) + 1
344
- )
345
-
346
- # Get metrics from expert engine
347
- if self.expert_engine:
348
- engine_metrics = self.expert_engine.get_metrics()
349
- adoption.total_consultations = max(
350
- adoption.total_consultations, engine_metrics.expert_consultations
351
- )
352
-
353
- # Calculate per-day and per-workflow (estimates)
354
- if adoption.total_consultations > 0:
355
- # Estimate: assume 1 consultation per workflow on average
356
- adoption.consultations_per_workflow = 1.0
357
- # Estimate: assume 5 consultations per day on average
358
- adoption.consultations_per_day = min(
359
- adoption.total_consultations / 30.0, 5.0
360
- )
361
- # Estimate: 50% of workflows use experts
362
- adoption.workflow_usage_percentage = 50.0
363
-
364
- return adoption
365
-
366
- def calculate_effectiveness_metrics(self) -> EffectivenessMetrics:
367
- """Calculate effectiveness metrics (quality improvements, bug prevention)."""
368
- effectiveness = EffectivenessMetrics()
369
-
370
- # Load correlation data
371
- correlations = self.storage._load_correlations()
372
-
373
- # Process correlations into improvements
374
- for consultation_id, correlation_data in correlations.items():
375
- improvement = CodeQualityImprovement(
376
- consultation_id=consultation_id,
377
- timestamp=datetime.fromisoformat(correlation_data["timestamp"]),
378
- before_score=correlation_data["before_score"],
379
- after_score=correlation_data["after_score"],
380
- improvement_percentage=(
381
- (correlation_data["after_score"] - correlation_data["before_score"])
382
- / correlation_data["before_score"]
383
- * 100
384
- if correlation_data["before_score"] > 0
385
- else 0.0
386
- ),
387
- expert_id="unknown", # Not stored in correlation
388
- domain="unknown", # Not stored in correlation
389
- )
390
- effectiveness.code_quality_improvements.append(improvement)
391
-
392
- # Calculate averages
393
- if effectiveness.code_quality_improvements:
394
- effectiveness.avg_quality_improvement = sum(
395
- imp.improvement_percentage
396
- for imp in effectiveness.code_quality_improvements
397
- ) / len(effectiveness.code_quality_improvements)
398
-
399
- # Set default time savings
400
- effectiveness.avg_time_savings_minutes = (
401
- self.time_savings_per_consultation_minutes
402
- )
403
-
404
- # Estimate bug prevention (10% of consultations prevent bugs)
405
- effectiveness.bug_prevention_rate = 0.1
406
- if self.confidence_tracker:
407
- metrics = self.confidence_tracker.get_metrics()
408
- effectiveness.total_bugs_prevented = int(len(metrics) * 0.1)
409
-
410
- return effectiveness
411
-
412
- def aggregate_quality_metrics(self) -> QualityMetrics:
413
- """Aggregate quality metrics (confidence, agreement, RAG quality)."""
414
- quality = QualityMetrics()
415
-
416
- if self.confidence_tracker:
417
- metrics = self.confidence_tracker.get_metrics()
418
-
419
- if metrics:
420
- # Calculate average confidence
421
- confidences = [m.confidence for m in metrics]
422
- quality.avg_confidence = sum(confidences) / len(confidences)
423
-
424
- # Get confidence trend (last 30 days)
425
- thirty_days_ago = datetime.now() - timedelta(days=30)
426
- recent_metrics = [
427
- m
428
- for m in metrics
429
- if hasattr(m, "timestamp")
430
- and m.timestamp >= thirty_days_ago
431
- ]
432
- if recent_metrics:
433
- quality.confidence_trend = [
434
- m.confidence for m in sorted(recent_metrics, key=lambda x: x.timestamp)
435
- ][-30:] # Last 30
436
-
437
- # Calculate average agreement level
438
- agreement_levels = [
439
- m.agreement_level
440
- for m in metrics
441
- if hasattr(m, "agreement_level")
442
- ]
443
- if agreement_levels:
444
- quality.avg_agreement_level = sum(agreement_levels) / len(
445
- agreement_levels
446
- )
447
-
448
- # Get operational metrics for RAG quality and cache hit rate
449
- if self.expert_engine:
450
- engine_metrics = self.expert_engine.get_metrics()
451
- quality.cache_hit_rate = engine_metrics.cache_hit_rate
452
- quality.rag_quality_score = (
453
- sum(engine_metrics.retrieval_quality_scores)
454
- / len(engine_metrics.retrieval_quality_scores)
455
- if engine_metrics.retrieval_quality_scores
456
- else 0.0
457
- )
458
-
459
- return quality
460
-
461
- def calculate_roi_metrics(self, total_consultations: int) -> ROIMetrics:
462
- """Calculate ROI metrics (time savings, costs, ROI)."""
463
- roi = ROIMetrics()
464
-
465
- roi.total_consultations = total_consultations
466
- roi.estimated_cost_per_consultation = self.cost_per_consultation
467
- roi.estimated_value_per_consultation = (
468
- self.time_savings_per_consultation_minutes / 60.0
469
- ) # Convert to hours
470
-
471
- # Calculate totals
472
- roi.total_cost = roi.total_consultations * roi.estimated_cost_per_consultation
473
- roi.total_value = (
474
- roi.total_consultations * roi.estimated_value_per_consultation
475
- )
476
-
477
- # Calculate ROI
478
- if roi.total_cost > 0:
479
- roi.roi_percentage = ((roi.total_value - roi.total_cost) / roi.total_cost) * 100
480
- else:
481
- roi.roi_percentage = 0.0
482
-
483
- roi.roi_per_consultation = (
484
- roi.estimated_value_per_consultation - roi.estimated_cost_per_consultation
485
- )
486
-
487
- roi.estimated_time_saved_hours = roi.total_value
488
-
489
- return roi
490
-
491
- def aggregate_operational_metrics(self) -> OperationalMetrics:
492
- """Aggregate operational metrics (system health)."""
493
- operational = OperationalMetrics()
494
-
495
- if self.expert_engine:
496
- engine_metrics = self.expert_engine.get_metrics()
497
- operational.cache_hit_rate = engine_metrics.cache_hit_rate
498
- operational.context7_hit_rate = engine_metrics.context7_hit_rate
499
- operational.local_kb_hit_rate = engine_metrics.local_kb_hit_rate
500
-
501
- return operational
502
-
503
- def record_code_quality_correlation(
504
- self,
505
- consultation_id: str,
506
- before_score: float,
507
- after_score: float,
508
- expert_id: str = "unknown",
509
- domain: str = "unknown",
510
- ) -> None:
511
- """
512
- Record code quality correlation (Phase 2).
513
-
514
- Args:
515
- consultation_id: Unique ID for the consultation
516
- before_score: Code quality score before expert consultation
517
- after_score: Code quality score after expert consultation
518
- expert_id: Expert that was consulted
519
- domain: Domain of the consultation
520
- """
521
- self.storage.save_correlation(consultation_id, before_score, after_score)
522
-
523
- # Also create improvement record
524
- improvement = CodeQualityImprovement(
525
- consultation_id=consultation_id,
526
- timestamp=datetime.now(),
527
- before_score=before_score,
528
- after_score=after_score,
529
- improvement_percentage=(
530
- (after_score - before_score) / before_score * 100
531
- if before_score > 0
532
- else 0.0
533
- ),
534
- expert_id=expert_id,
535
- domain=domain,
536
- )
537
-
538
- # Load current metrics and add improvement
539
- current = self.storage.load_current_metrics()
540
- if current:
541
- current.effectiveness_metrics.code_quality_improvements.append(
542
- improvement
543
- )
544
- self.storage.save_metrics(current)
545
-
546
-
547
- def get_business_metrics_collector(
548
- expert_engine: ExpertEngine | None = None,
549
- storage_path: Path | None = None,
550
- ) -> BusinessMetricsCollector:
551
- """
552
- Factory function to get or create BusinessMetricsCollector.
553
-
554
- Args:
555
- expert_engine: Optional ExpertEngine instance
556
- storage_path: Optional storage path
557
-
558
- Returns:
559
- BusinessMetricsCollector instance
560
- """
561
- return BusinessMetricsCollector(
562
- expert_engine=expert_engine,
563
- confidence_tracker=get_tracker(),
564
- storage_path=storage_path,
565
- )
1
+ """
2
+ Business Metrics Collection for Experts Feature
3
+
4
+ Collects and aggregates business metrics from technical metrics to demonstrate
5
+ the business value and ROI of expert consultations.
6
+
7
+ Phases:
8
+ - Phase 1: Aggregate existing technical metrics into business metrics
9
+ - Phase 2: Correlate expert consultations with code quality scores
10
+ - Phase 3: Calculate ROI and track user value
11
+ """
12
+
13
+ from __future__ import annotations
14
+
15
+ import json
16
+ import logging
17
+ from dataclasses import asdict, dataclass, field
18
+ from datetime import datetime, timedelta
19
+ from pathlib import Path
20
+ from typing import Any
21
+
22
+ from .confidence_metrics import ConfidenceMetricsTracker, get_tracker
23
+ from .expert_engine import ExpertEngine, ExpertEngineMetrics
24
+
25
+ logger = logging.getLogger(__name__)
26
+
27
+
28
+ @dataclass
29
+ class AdoptionMetrics:
30
+ """Adoption and usage metrics."""
31
+
32
+ total_consultations: int = 0
33
+ consultations_per_workflow: float = 0.0
34
+ consultations_per_day: float = 0.0
35
+ expert_usage_by_id: dict[str, int] = field(default_factory=dict)
36
+ domain_usage: dict[str, int] = field(default_factory=dict)
37
+ agent_usage: dict[str, int] = field(default_factory=dict)
38
+ workflow_usage_percentage: float = 0.0
39
+
40
+
41
+ @dataclass
42
+ class CodeQualityImprovement:
43
+ """Single code quality improvement record."""
44
+
45
+ consultation_id: str
46
+ timestamp: datetime
47
+ before_score: float
48
+ after_score: float
49
+ improvement_percentage: float
50
+ expert_id: str
51
+ domain: str
52
+
53
+
54
+ @dataclass
55
+ class EffectivenessMetrics:
56
+ """Effectiveness and impact metrics."""
57
+
58
+ code_quality_improvements: list[CodeQualityImprovement] = field(
59
+ default_factory=list
60
+ )
61
+ avg_quality_improvement: float = 0.0
62
+ bug_prevention_rate: float = 0.0
63
+ avg_time_savings_minutes: float = 15.0 # Default estimate
64
+ total_bugs_prevented: int = 0
65
+
66
+
67
+ @dataclass
68
+ class QualityMetrics:
69
+ """Quality and performance metrics."""
70
+
71
+ avg_confidence: float = 0.0
72
+ confidence_trend: list[float] = field(default_factory=list)
73
+ avg_agreement_level: float = 0.0
74
+ rag_quality_score: float = 0.0
75
+ cache_hit_rate: float = 0.0
76
+ avg_latency_ms: float = 0.0
77
+
78
+
79
+ @dataclass
80
+ class ROIMetrics:
81
+ """ROI and business value metrics."""
82
+
83
+ total_consultations: int = 0
84
+ estimated_time_saved_hours: float = 0.0
85
+ estimated_cost_per_consultation: float = 0.01 # Infrastructure cost
86
+ estimated_value_per_consultation: float = 0.0 # Time saved value
87
+ total_cost: float = 0.0
88
+ total_value: float = 0.0
89
+ roi_percentage: float = 0.0
90
+ roi_per_consultation: float = 0.0
91
+
92
+
93
+ @dataclass
94
+ class OperationalMetrics:
95
+ """System health and operational metrics."""
96
+
97
+ cache_hit_rate: float = 0.0
98
+ context7_hit_rate: float = 0.0
99
+ local_kb_hit_rate: float = 0.0
100
+ avg_latency_ms: float = 0.0
101
+ error_rate: float = 0.0
102
+ knowledge_base_size: int = 0
103
+
104
+
105
+ @dataclass
106
+ class BusinessMetricsData:
107
+ """Complete business metrics snapshot."""
108
+
109
+ timestamp: datetime
110
+ adoption_metrics: AdoptionMetrics
111
+ effectiveness_metrics: EffectivenessMetrics
112
+ quality_metrics: QualityMetrics
113
+ roi_metrics: ROIMetrics
114
+ operational_metrics: OperationalMetrics
115
+
116
+ def to_dict(self) -> dict[str, Any]:
117
+ """Convert to dictionary for JSON serialization."""
118
+ data = asdict(self)
119
+ # Convert datetime to ISO format string
120
+ data["timestamp"] = self.timestamp.isoformat()
121
+ # Convert CodeQualityImprovement datetimes
122
+ for improvement in data["effectiveness_metrics"]["code_quality_improvements"]:
123
+ if isinstance(improvement.get("timestamp"), datetime):
124
+ improvement["timestamp"] = improvement["timestamp"].isoformat()
125
+ return data
126
+
127
+ @classmethod
128
+ def from_dict(cls, data: dict[str, Any]) -> BusinessMetricsData:
129
+ """Create from dictionary (from JSON)."""
130
+ # Convert ISO format string back to datetime
131
+ if isinstance(data.get("timestamp"), str):
132
+ data["timestamp"] = datetime.fromisoformat(data["timestamp"])
133
+
134
+ # Convert CodeQualityImprovement timestamps
135
+ for improvement in data.get("effectiveness_metrics", {}).get(
136
+ "code_quality_improvements", []
137
+ ):
138
+ if isinstance(improvement.get("timestamp"), str):
139
+ improvement["timestamp"] = datetime.fromisoformat(
140
+ improvement["timestamp"]
141
+ )
142
+
143
+ return cls(**data)
144
+
145
+
146
+ class MetricsStorage:
147
+ """File-based storage for business metrics."""
148
+
149
+ def __init__(self, storage_path: Path | None = None):
150
+ """
151
+ Initialize metrics storage.
152
+
153
+ Args:
154
+ storage_path: Path to metrics directory (default: .tapps-agents/metrics)
155
+ """
156
+ if storage_path is None:
157
+ storage_path = Path(".tapps-agents") / "metrics"
158
+ self.storage_path = storage_path
159
+ self.storage_path.mkdir(parents=True, exist_ok=True)
160
+
161
+ self.current_metrics_file = self.storage_path / "business_metrics.json"
162
+ self.history_file = self.storage_path / "business_metrics_history.json"
163
+ self.correlations_file = self.storage_path / "correlations.json"
164
+
165
+ def save_metrics(self, metrics: BusinessMetricsData) -> None:
166
+ """Save metrics to JSON file."""
167
+ try:
168
+ # Save current snapshot
169
+ with open(self.current_metrics_file, "w", encoding="utf-8") as f:
170
+ json.dump(metrics.to_dict(), f, indent=2)
171
+
172
+ # Append to history
173
+ history = self._load_history()
174
+ history.append(metrics.to_dict())
175
+ with open(self.history_file, "w", encoding="utf-8") as f:
176
+ json.dump(history, f, indent=2)
177
+
178
+ logger.debug(f"Saved business metrics to {self.current_metrics_file}")
179
+ except Exception as e:
180
+ logger.error(f"Failed to save business metrics: {e}", exc_info=True)
181
+
182
+ def load_current_metrics(self) -> BusinessMetricsData | None:
183
+ """Load current metrics snapshot."""
184
+ if not self.current_metrics_file.exists():
185
+ return None
186
+
187
+ try:
188
+ with open(self.current_metrics_file, "r", encoding="utf-8") as f:
189
+ data = json.load(f)
190
+ return BusinessMetricsData.from_dict(data)
191
+ except Exception as e:
192
+ logger.error(f"Failed to load current metrics: {e}", exc_info=True)
193
+ return None
194
+
195
+ def load_historical_metrics(
196
+ self,
197
+ start_date: datetime | None = None,
198
+ end_date: datetime | None = None,
199
+ ) -> list[BusinessMetricsData]:
200
+ """Load historical metrics for date range."""
201
+ history = self._load_history()
202
+ metrics_list = []
203
+
204
+ for entry in history:
205
+ try:
206
+ metrics = BusinessMetricsData.from_dict(entry)
207
+ timestamp = metrics.timestamp
208
+
209
+ # Filter by date range
210
+ if start_date and timestamp < start_date:
211
+ continue
212
+ if end_date and timestamp > end_date:
213
+ continue
214
+
215
+ metrics_list.append(metrics)
216
+ except Exception as e:
217
+ logger.warning(f"Failed to parse historical metric entry: {e}")
218
+ continue
219
+
220
+ return metrics_list
221
+
222
+ def save_correlation(
223
+ self, consultation_id: str, before_score: float, after_score: float
224
+ ) -> None:
225
+ """Save code quality correlation data."""
226
+ correlations = self._load_correlations()
227
+ correlations[consultation_id] = {
228
+ "timestamp": datetime.now().isoformat(),
229
+ "before_score": before_score,
230
+ "after_score": after_score,
231
+ "improvement": after_score - before_score,
232
+ }
233
+
234
+ try:
235
+ with open(self.correlations_file, "w", encoding="utf-8") as f:
236
+ json.dump(correlations, f, indent=2)
237
+ except Exception as e:
238
+ logger.error(f"Failed to save correlation: {e}", exc_info=True)
239
+
240
+ def _load_history(self) -> list[dict[str, Any]]:
241
+ """Load history file."""
242
+ if not self.history_file.exists():
243
+ return []
244
+ try:
245
+ with open(self.history_file, "r", encoding="utf-8") as f:
246
+ return json.load(f)
247
+ except Exception:
248
+ return []
249
+
250
+ def _load_correlations(self) -> dict[str, Any]:
251
+ """Load correlations file."""
252
+ if not self.correlations_file.exists():
253
+ return {}
254
+ try:
255
+ with open(self.correlations_file, "r", encoding="utf-8") as f:
256
+ return json.load(f)
257
+ except Exception:
258
+ return {}
259
+
260
+
261
+ class BusinessMetricsCollector:
262
+ """Collects and aggregates business metrics from technical metrics."""
263
+
264
+ def __init__(
265
+ self,
266
+ expert_engine: ExpertEngine | None = None,
267
+ confidence_tracker: ConfidenceMetricsTracker | None = None,
268
+ storage_path: Path | None = None,
269
+ time_savings_per_consultation_minutes: float = 15.0,
270
+ cost_per_consultation: float = 0.01,
271
+ ):
272
+ """
273
+ Initialize business metrics collector.
274
+
275
+ Args:
276
+ expert_engine: ExpertEngine instance (optional)
277
+ confidence_tracker: ConfidenceMetricsTracker instance (optional)
278
+ storage_path: Path to metrics storage directory
279
+ time_savings_per_consultation_minutes: Estimated time saved per consultation
280
+ cost_per_consultation: Estimated infrastructure cost per consultation
281
+ """
282
+ self.expert_engine = expert_engine
283
+ self.confidence_tracker = confidence_tracker or get_tracker()
284
+ self.storage = MetricsStorage(storage_path)
285
+ self.time_savings_per_consultation_minutes = time_savings_per_consultation_minutes
286
+ self.cost_per_consultation = cost_per_consultation
287
+
288
+ async def collect_metrics(self) -> BusinessMetricsData:
289
+ """Collect current business metrics from all sources."""
290
+ # Aggregate adoption metrics
291
+ adoption = self.aggregate_adoption_metrics()
292
+
293
+ # Calculate effectiveness metrics
294
+ effectiveness = self.calculate_effectiveness_metrics()
295
+
296
+ # Aggregate quality metrics
297
+ quality = self.aggregate_quality_metrics()
298
+
299
+ # Calculate ROI metrics
300
+ roi = self.calculate_roi_metrics(adoption.total_consultations)
301
+
302
+ # Aggregate operational metrics
303
+ operational = self.aggregate_operational_metrics()
304
+
305
+ metrics = BusinessMetricsData(
306
+ timestamp=datetime.now(),
307
+ adoption_metrics=adoption,
308
+ effectiveness_metrics=effectiveness,
309
+ quality_metrics=quality,
310
+ roi_metrics=roi,
311
+ operational_metrics=operational,
312
+ )
313
+
314
+ # Save metrics
315
+ self.storage.save_metrics(metrics)
316
+
317
+ return metrics
318
+
319
+ def aggregate_adoption_metrics(self) -> AdoptionMetrics:
320
+ """Aggregate adoption metrics (usage, frequency, popularity)."""
321
+ adoption = AdoptionMetrics()
322
+
323
+ # Get metrics from confidence tracker
324
+ if self.confidence_tracker:
325
+ metrics = self.confidence_tracker.get_metrics()
326
+ adoption.total_consultations = len(metrics)
327
+
328
+ # Count by expert, domain, agent
329
+ for metric in metrics:
330
+ # Expert usage (from primary_expert or domain)
331
+ expert_id = getattr(metric, "primary_expert", None) or metric.domain
332
+ adoption.expert_usage_by_id[expert_id] = (
333
+ adoption.expert_usage_by_id.get(expert_id, 0) + 1
334
+ )
335
+
336
+ # Domain usage
337
+ adoption.domain_usage[metric.domain] = (
338
+ adoption.domain_usage.get(metric.domain, 0) + 1
339
+ )
340
+
341
+ # Agent usage
342
+ adoption.agent_usage[metric.agent_id] = (
343
+ adoption.agent_usage.get(metric.agent_id, 0) + 1
344
+ )
345
+
346
+ # Get metrics from expert engine
347
+ if self.expert_engine:
348
+ engine_metrics = self.expert_engine.get_metrics()
349
+ adoption.total_consultations = max(
350
+ adoption.total_consultations, engine_metrics.expert_consultations
351
+ )
352
+
353
+ # Calculate per-day and per-workflow (estimates)
354
+ if adoption.total_consultations > 0:
355
+ # Estimate: assume 1 consultation per workflow on average
356
+ adoption.consultations_per_workflow = 1.0
357
+ # Estimate: assume 5 consultations per day on average
358
+ adoption.consultations_per_day = min(
359
+ adoption.total_consultations / 30.0, 5.0
360
+ )
361
+ # Estimate: 50% of workflows use experts
362
+ adoption.workflow_usage_percentage = 50.0
363
+
364
+ return adoption
365
+
366
+ def calculate_effectiveness_metrics(self) -> EffectivenessMetrics:
367
+ """Calculate effectiveness metrics (quality improvements, bug prevention)."""
368
+ effectiveness = EffectivenessMetrics()
369
+
370
+ # Load correlation data
371
+ correlations = self.storage._load_correlations()
372
+
373
+ # Process correlations into improvements
374
+ for consultation_id, correlation_data in correlations.items():
375
+ improvement = CodeQualityImprovement(
376
+ consultation_id=consultation_id,
377
+ timestamp=datetime.fromisoformat(correlation_data["timestamp"]),
378
+ before_score=correlation_data["before_score"],
379
+ after_score=correlation_data["after_score"],
380
+ improvement_percentage=(
381
+ (correlation_data["after_score"] - correlation_data["before_score"])
382
+ / correlation_data["before_score"]
383
+ * 100
384
+ if correlation_data["before_score"] > 0
385
+ else 0.0
386
+ ),
387
+ expert_id="unknown", # Not stored in correlation
388
+ domain="unknown", # Not stored in correlation
389
+ )
390
+ effectiveness.code_quality_improvements.append(improvement)
391
+
392
+ # Calculate averages
393
+ if effectiveness.code_quality_improvements:
394
+ effectiveness.avg_quality_improvement = sum(
395
+ imp.improvement_percentage
396
+ for imp in effectiveness.code_quality_improvements
397
+ ) / len(effectiveness.code_quality_improvements)
398
+
399
+ # Set default time savings
400
+ effectiveness.avg_time_savings_minutes = (
401
+ self.time_savings_per_consultation_minutes
402
+ )
403
+
404
+ # Estimate bug prevention (10% of consultations prevent bugs)
405
+ effectiveness.bug_prevention_rate = 0.1
406
+ if self.confidence_tracker:
407
+ metrics = self.confidence_tracker.get_metrics()
408
+ effectiveness.total_bugs_prevented = int(len(metrics) * 0.1)
409
+
410
+ return effectiveness
411
+
412
+ def aggregate_quality_metrics(self) -> QualityMetrics:
413
+ """Aggregate quality metrics (confidence, agreement, RAG quality)."""
414
+ quality = QualityMetrics()
415
+
416
+ if self.confidence_tracker:
417
+ metrics = self.confidence_tracker.get_metrics()
418
+
419
+ if metrics:
420
+ # Calculate average confidence
421
+ confidences = [m.confidence for m in metrics]
422
+ quality.avg_confidence = sum(confidences) / len(confidences)
423
+
424
+ # Get confidence trend (last 30 days)
425
+ thirty_days_ago = datetime.now() - timedelta(days=30)
426
+ recent_metrics = [
427
+ m
428
+ for m in metrics
429
+ if hasattr(m, "timestamp")
430
+ and m.timestamp >= thirty_days_ago
431
+ ]
432
+ if recent_metrics:
433
+ quality.confidence_trend = [
434
+ m.confidence for m in sorted(recent_metrics, key=lambda x: x.timestamp)
435
+ ][-30:] # Last 30
436
+
437
+ # Calculate average agreement level
438
+ agreement_levels = [
439
+ m.agreement_level
440
+ for m in metrics
441
+ if hasattr(m, "agreement_level")
442
+ ]
443
+ if agreement_levels:
444
+ quality.avg_agreement_level = sum(agreement_levels) / len(
445
+ agreement_levels
446
+ )
447
+
448
+ # Get operational metrics for RAG quality and cache hit rate
449
+ if self.expert_engine:
450
+ engine_metrics = self.expert_engine.get_metrics()
451
+ quality.cache_hit_rate = engine_metrics.cache_hit_rate
452
+ quality.rag_quality_score = (
453
+ sum(engine_metrics.retrieval_quality_scores)
454
+ / len(engine_metrics.retrieval_quality_scores)
455
+ if engine_metrics.retrieval_quality_scores
456
+ else 0.0
457
+ )
458
+
459
+ return quality
460
+
461
+ def calculate_roi_metrics(self, total_consultations: int) -> ROIMetrics:
462
+ """Calculate ROI metrics (time savings, costs, ROI)."""
463
+ roi = ROIMetrics()
464
+
465
+ roi.total_consultations = total_consultations
466
+ roi.estimated_cost_per_consultation = self.cost_per_consultation
467
+ roi.estimated_value_per_consultation = (
468
+ self.time_savings_per_consultation_minutes / 60.0
469
+ ) # Convert to hours
470
+
471
+ # Calculate totals
472
+ roi.total_cost = roi.total_consultations * roi.estimated_cost_per_consultation
473
+ roi.total_value = (
474
+ roi.total_consultations * roi.estimated_value_per_consultation
475
+ )
476
+
477
+ # Calculate ROI
478
+ if roi.total_cost > 0:
479
+ roi.roi_percentage = ((roi.total_value - roi.total_cost) / roi.total_cost) * 100
480
+ else:
481
+ roi.roi_percentage = 0.0
482
+
483
+ roi.roi_per_consultation = (
484
+ roi.estimated_value_per_consultation - roi.estimated_cost_per_consultation
485
+ )
486
+
487
+ roi.estimated_time_saved_hours = roi.total_value
488
+
489
+ return roi
490
+
491
+ def aggregate_operational_metrics(self) -> OperationalMetrics:
492
+ """Aggregate operational metrics (system health)."""
493
+ operational = OperationalMetrics()
494
+
495
+ if self.expert_engine:
496
+ engine_metrics = self.expert_engine.get_metrics()
497
+ operational.cache_hit_rate = engine_metrics.cache_hit_rate
498
+ operational.context7_hit_rate = engine_metrics.context7_hit_rate
499
+ operational.local_kb_hit_rate = engine_metrics.local_kb_hit_rate
500
+
501
+ return operational
502
+
503
+ def record_code_quality_correlation(
504
+ self,
505
+ consultation_id: str,
506
+ before_score: float,
507
+ after_score: float,
508
+ expert_id: str = "unknown",
509
+ domain: str = "unknown",
510
+ ) -> None:
511
+ """
512
+ Record code quality correlation (Phase 2).
513
+
514
+ Args:
515
+ consultation_id: Unique ID for the consultation
516
+ before_score: Code quality score before expert consultation
517
+ after_score: Code quality score after expert consultation
518
+ expert_id: Expert that was consulted
519
+ domain: Domain of the consultation
520
+ """
521
+ self.storage.save_correlation(consultation_id, before_score, after_score)
522
+
523
+ # Also create improvement record
524
+ improvement = CodeQualityImprovement(
525
+ consultation_id=consultation_id,
526
+ timestamp=datetime.now(),
527
+ before_score=before_score,
528
+ after_score=after_score,
529
+ improvement_percentage=(
530
+ (after_score - before_score) / before_score * 100
531
+ if before_score > 0
532
+ else 0.0
533
+ ),
534
+ expert_id=expert_id,
535
+ domain=domain,
536
+ )
537
+
538
+ # Load current metrics and add improvement
539
+ current = self.storage.load_current_metrics()
540
+ if current:
541
+ current.effectiveness_metrics.code_quality_improvements.append(
542
+ improvement
543
+ )
544
+ self.storage.save_metrics(current)
545
+
546
+
547
+ def get_business_metrics_collector(
548
+ expert_engine: ExpertEngine | None = None,
549
+ storage_path: Path | None = None,
550
+ ) -> BusinessMetricsCollector:
551
+ """
552
+ Factory function to get or create BusinessMetricsCollector.
553
+
554
+ Args:
555
+ expert_engine: Optional ExpertEngine instance
556
+ storage_path: Optional storage path
557
+
558
+ Returns:
559
+ BusinessMetricsCollector instance
560
+ """
561
+ return BusinessMetricsCollector(
562
+ expert_engine=expert_engine,
563
+ confidence_tracker=get_tracker(),
564
+ storage_path=storage_path,
565
+ )