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,373 +1,373 @@
1
- # User Research Methods
2
-
3
- ## Overview
4
-
5
- User research is the process of understanding user behaviors, needs, and motivations through observation, task analysis, and other feedback methodologies. It is essential for creating user-centered designs.
6
-
7
- ## Research Goals
8
-
9
- ### Understanding Users
10
- - User behaviors
11
- - User needs
12
- - User motivations
13
- - User pain points
14
- - User goals
15
-
16
- ### Informing Design
17
- - Design decisions
18
- - Feature priorities
19
- - Interaction patterns
20
- - Content strategy
21
- - Information architecture
22
-
23
- ### Validating Solutions
24
- - Test prototypes
25
- - Validate assumptions
26
- - Measure success
27
- - Identify issues
28
- - Improve designs
29
-
30
- ## Research Methods
31
-
32
- ### Qualitative Research
33
-
34
- #### User Interviews
35
- - One-on-one conversations
36
- - In-depth understanding
37
- - Open-ended questions
38
- - User perspectives
39
- - Rich insights
40
-
41
- **Best Practices:**
42
- - Prepare questions
43
- - Create comfortable environment
44
- - Listen actively
45
- - Ask follow-up questions
46
- - Document findings
47
-
48
- #### Focus Groups
49
- - Group discussions
50
- - Multiple perspectives
51
- - Group dynamics
52
- - Diverse opinions
53
- - Moderated sessions
54
-
55
- **Best Practices:**
56
- - Small groups (6-8 people)
57
- - Skilled moderator
58
- - Clear objectives
59
- - Diverse participants
60
- - Document insights
61
-
62
- #### Contextual Inquiry
63
- - Observe users in context
64
- - Natural environment
65
- - Real tasks
66
- - Actual behavior
67
- - Rich context
68
-
69
- **Best Practices:**
70
- - Visit user environment
71
- - Observe without interfering
72
- - Ask clarifying questions
73
- - Document observations
74
- - Analyze patterns
75
-
76
- #### Ethnographic Research
77
- - Immersive observation
78
- - Cultural context
79
- - Long-term study
80
- - Natural behavior
81
- - Deep understanding
82
-
83
- ### Quantitative Research
84
-
85
- #### Surveys
86
- - Large sample sizes
87
- - Statistical data
88
- - Quick to deploy
89
- - Broad reach
90
- - Quantifiable results
91
-
92
- **Best Practices:**
93
- - Clear questions
94
- - Appropriate length
95
- - Multiple choice options
96
- - Open-ended questions
97
- - Analyze results
98
-
99
- #### Analytics
100
- - Behavioral data
101
- - Usage patterns
102
- - Traffic sources
103
- - User flows
104
- - Conversion rates
105
-
106
- **Best Practices:**
107
- - Set up tracking
108
- - Define metrics
109
- - Regular analysis
110
- - Identify trends
111
- - Actionable insights
112
-
113
- #### A/B Testing
114
- - Compare variants
115
- - Statistical significance
116
- - Data-driven decisions
117
- - Measure impact
118
- - Optimize performance
119
-
120
- **Best Practices:**
121
- - Clear hypothesis
122
- - Sufficient sample size
123
- - One variable at a time
124
- - Statistical significance
125
- - Document results
126
-
127
- ## Research Phases
128
-
129
- ### Discovery Phase
130
- - Understand problem space
131
- - Identify user needs
132
- - Explore opportunities
133
- - Gather initial insights
134
- - Define research questions
135
-
136
- **Methods:**
137
- - User interviews
138
- - Surveys
139
- - Competitive analysis
140
- - Stakeholder interviews
141
- - Literature review
142
-
143
- ### Design Phase
144
- - Inform design decisions
145
- - Validate concepts
146
- - Test early ideas
147
- - Gather feedback
148
- - Iterate designs
149
-
150
- **Methods:**
151
- - Concept testing
152
- - Card sorting
153
- - Tree testing
154
- - Prototype testing
155
- - Design reviews
156
-
157
- ### Validation Phase
158
- - Test solutions
159
- - Measure success
160
- - Identify issues
161
- - Validate assumptions
162
- - Improve designs
163
-
164
- **Methods:**
165
- - Usability testing
166
- - A/B testing
167
- - Analytics
168
- - User feedback
169
- - Performance metrics
170
-
171
- ## User Personas
172
-
173
- ### Creating Personas
174
- - Based on research
175
- - Representative users
176
- - Key characteristics
177
- - Goals and needs
178
- - Pain points
179
-
180
- ### Persona Components
181
- - Name and photo
182
- - Demographics
183
- - Goals
184
- - Needs
185
- - Pain points
186
- - Behaviors
187
- - Quotes
188
-
189
- ### Using Personas
190
- - Design decisions
191
- - Feature prioritization
192
- - Content strategy
193
- - Team alignment
194
- - User advocacy
195
-
196
- ## User Journey Mapping
197
-
198
- ### Journey Map Components
199
- - User persona
200
- - Stages/phases
201
- - Touchpoints
202
- - Actions
203
- - Emotions
204
- - Pain points
205
- - Opportunities
206
-
207
- ### Creating Journey Maps
208
- 1. Define persona
209
- 2. Identify stages
210
- 3. Map touchpoints
211
- 4. Document actions
212
- 5. Capture emotions
213
- 6. Identify pain points
214
- 7. Find opportunities
215
-
216
- ## Research Planning
217
-
218
- ### Define Objectives
219
- - Research questions
220
- - Success criteria
221
- - Key metrics
222
- - Timeline
223
- - Budget
224
-
225
- ### Recruit Participants
226
- - Target audience
227
- - Screening criteria
228
- - Recruitment methods
229
- - Incentives
230
- - Scheduling
231
-
232
- ### Prepare Materials
233
- - Interview guides
234
- - Survey questions
235
- - Prototypes
236
- - Consent forms
237
- - Documentation tools
238
-
239
- ### Conduct Research
240
- - Follow protocol
241
- - Document findings
242
- - Ask follow-ups
243
- - Stay objective
244
- - Respect participants
245
-
246
- ### Analyze Results
247
- - Organize data
248
- - Identify patterns
249
- - Synthesize insights
250
- - Create deliverables
251
- - Share findings
252
-
253
- ## Research Deliverables
254
-
255
- ### Research Reports
256
- - Executive summary
257
- - Methodology
258
- - Findings
259
- - Insights
260
- - Recommendations
261
-
262
- ### Personas
263
- - User profiles
264
- - Characteristics
265
- - Goals and needs
266
- - Use cases
267
-
268
- ### Journey Maps
269
- - User journeys
270
- - Touchpoints
271
- - Pain points
272
- - Opportunities
273
-
274
- ### Design Recommendations
275
- - Actionable insights
276
- - Design implications
277
- - Feature priorities
278
- - Next steps
279
-
280
- ## Best Practices
281
-
282
- ### 1. Start Early
283
- - Research before design
284
- - Continuous research
285
- - Iterative approach
286
- - Early validation
287
-
288
- ### 2. Mix Methods
289
- - Qualitative and quantitative
290
- - Multiple perspectives
291
- - Triangulate findings
292
- - Comprehensive understanding
293
-
294
- ### 3. Involve Stakeholders
295
- - Share findings
296
- - Get buy-in
297
- - Align team
298
- - Build consensus
299
-
300
- ### 4. Document Everything
301
- - Research notes
302
- - Findings
303
- - Insights
304
- - Recommendations
305
- - Share widely
306
-
307
- ### 5. Act on Findings
308
- - Implement insights
309
- - Prioritize changes
310
- - Measure impact
311
- - Iterate based on results
312
-
313
- ## Common Mistakes
314
-
315
- ### 1. Not Researching
316
- - Assuming user needs
317
- - No validation
318
- - Design in vacuum
319
- - Ignoring users
320
-
321
- ### 2. Biased Research
322
- - Leading questions
323
- - Confirmation bias
324
- - Small sample sizes
325
- - Unrepresentative users
326
-
327
- ### 3. Poor Documentation
328
- - Lost insights
329
- - Not shared
330
- - No action
331
- - Forgotten findings
332
-
333
- ### 4. Research for Research's Sake
334
- - No clear objectives
335
- - Not actionable
336
- - No follow-up
337
- - Wasted effort
338
-
339
- ## Tools and Resources
340
-
341
- ### Research Tools
342
- - UserTesting
343
- - Lookback
344
- - Dovetail
345
- - Miro
346
- - Optimal Workshop
347
-
348
- ### Analytics Tools
349
- - Google Analytics
350
- - Hotjar
351
- - Mixpanel
352
- - Amplitude
353
- - FullStory
354
-
355
- ### Survey Tools
356
- - SurveyMonkey
357
- - Typeform
358
- - Google Forms
359
- - Qualtrics
360
-
361
- ## Best Practices Summary
362
-
363
- 1. **Start Early**: Research before design
364
- 2. **Mix Methods**: Qualitative and quantitative
365
- 3. **User-Centered**: Focus on users
366
- 4. **Document**: Capture all insights
367
- 5. **Share**: Communicate findings
368
- 6. **Act**: Implement recommendations
369
- 7. **Iterate**: Continuous research
370
- 8. **Validate**: Test assumptions
371
- 9. **Measure**: Track success
372
- 10. **Improve**: Learn and adapt
373
-
1
+ # User Research Methods
2
+
3
+ ## Overview
4
+
5
+ User research is the process of understanding user behaviors, needs, and motivations through observation, task analysis, and other feedback methodologies. It is essential for creating user-centered designs.
6
+
7
+ ## Research Goals
8
+
9
+ ### Understanding Users
10
+ - User behaviors
11
+ - User needs
12
+ - User motivations
13
+ - User pain points
14
+ - User goals
15
+
16
+ ### Informing Design
17
+ - Design decisions
18
+ - Feature priorities
19
+ - Interaction patterns
20
+ - Content strategy
21
+ - Information architecture
22
+
23
+ ### Validating Solutions
24
+ - Test prototypes
25
+ - Validate assumptions
26
+ - Measure success
27
+ - Identify issues
28
+ - Improve designs
29
+
30
+ ## Research Methods
31
+
32
+ ### Qualitative Research
33
+
34
+ #### User Interviews
35
+ - One-on-one conversations
36
+ - In-depth understanding
37
+ - Open-ended questions
38
+ - User perspectives
39
+ - Rich insights
40
+
41
+ **Best Practices:**
42
+ - Prepare questions
43
+ - Create comfortable environment
44
+ - Listen actively
45
+ - Ask follow-up questions
46
+ - Document findings
47
+
48
+ #### Focus Groups
49
+ - Group discussions
50
+ - Multiple perspectives
51
+ - Group dynamics
52
+ - Diverse opinions
53
+ - Moderated sessions
54
+
55
+ **Best Practices:**
56
+ - Small groups (6-8 people)
57
+ - Skilled moderator
58
+ - Clear objectives
59
+ - Diverse participants
60
+ - Document insights
61
+
62
+ #### Contextual Inquiry
63
+ - Observe users in context
64
+ - Natural environment
65
+ - Real tasks
66
+ - Actual behavior
67
+ - Rich context
68
+
69
+ **Best Practices:**
70
+ - Visit user environment
71
+ - Observe without interfering
72
+ - Ask clarifying questions
73
+ - Document observations
74
+ - Analyze patterns
75
+
76
+ #### Ethnographic Research
77
+ - Immersive observation
78
+ - Cultural context
79
+ - Long-term study
80
+ - Natural behavior
81
+ - Deep understanding
82
+
83
+ ### Quantitative Research
84
+
85
+ #### Surveys
86
+ - Large sample sizes
87
+ - Statistical data
88
+ - Quick to deploy
89
+ - Broad reach
90
+ - Quantifiable results
91
+
92
+ **Best Practices:**
93
+ - Clear questions
94
+ - Appropriate length
95
+ - Multiple choice options
96
+ - Open-ended questions
97
+ - Analyze results
98
+
99
+ #### Analytics
100
+ - Behavioral data
101
+ - Usage patterns
102
+ - Traffic sources
103
+ - User flows
104
+ - Conversion rates
105
+
106
+ **Best Practices:**
107
+ - Set up tracking
108
+ - Define metrics
109
+ - Regular analysis
110
+ - Identify trends
111
+ - Actionable insights
112
+
113
+ #### A/B Testing
114
+ - Compare variants
115
+ - Statistical significance
116
+ - Data-driven decisions
117
+ - Measure impact
118
+ - Optimize performance
119
+
120
+ **Best Practices:**
121
+ - Clear hypothesis
122
+ - Sufficient sample size
123
+ - One variable at a time
124
+ - Statistical significance
125
+ - Document results
126
+
127
+ ## Research Phases
128
+
129
+ ### Discovery Phase
130
+ - Understand problem space
131
+ - Identify user needs
132
+ - Explore opportunities
133
+ - Gather initial insights
134
+ - Define research questions
135
+
136
+ **Methods:**
137
+ - User interviews
138
+ - Surveys
139
+ - Competitive analysis
140
+ - Stakeholder interviews
141
+ - Literature review
142
+
143
+ ### Design Phase
144
+ - Inform design decisions
145
+ - Validate concepts
146
+ - Test early ideas
147
+ - Gather feedback
148
+ - Iterate designs
149
+
150
+ **Methods:**
151
+ - Concept testing
152
+ - Card sorting
153
+ - Tree testing
154
+ - Prototype testing
155
+ - Design reviews
156
+
157
+ ### Validation Phase
158
+ - Test solutions
159
+ - Measure success
160
+ - Identify issues
161
+ - Validate assumptions
162
+ - Improve designs
163
+
164
+ **Methods:**
165
+ - Usability testing
166
+ - A/B testing
167
+ - Analytics
168
+ - User feedback
169
+ - Performance metrics
170
+
171
+ ## User Personas
172
+
173
+ ### Creating Personas
174
+ - Based on research
175
+ - Representative users
176
+ - Key characteristics
177
+ - Goals and needs
178
+ - Pain points
179
+
180
+ ### Persona Components
181
+ - Name and photo
182
+ - Demographics
183
+ - Goals
184
+ - Needs
185
+ - Pain points
186
+ - Behaviors
187
+ - Quotes
188
+
189
+ ### Using Personas
190
+ - Design decisions
191
+ - Feature prioritization
192
+ - Content strategy
193
+ - Team alignment
194
+ - User advocacy
195
+
196
+ ## User Journey Mapping
197
+
198
+ ### Journey Map Components
199
+ - User persona
200
+ - Stages/phases
201
+ - Touchpoints
202
+ - Actions
203
+ - Emotions
204
+ - Pain points
205
+ - Opportunities
206
+
207
+ ### Creating Journey Maps
208
+ 1. Define persona
209
+ 2. Identify stages
210
+ 3. Map touchpoints
211
+ 4. Document actions
212
+ 5. Capture emotions
213
+ 6. Identify pain points
214
+ 7. Find opportunities
215
+
216
+ ## Research Planning
217
+
218
+ ### Define Objectives
219
+ - Research questions
220
+ - Success criteria
221
+ - Key metrics
222
+ - Timeline
223
+ - Budget
224
+
225
+ ### Recruit Participants
226
+ - Target audience
227
+ - Screening criteria
228
+ - Recruitment methods
229
+ - Incentives
230
+ - Scheduling
231
+
232
+ ### Prepare Materials
233
+ - Interview guides
234
+ - Survey questions
235
+ - Prototypes
236
+ - Consent forms
237
+ - Documentation tools
238
+
239
+ ### Conduct Research
240
+ - Follow protocol
241
+ - Document findings
242
+ - Ask follow-ups
243
+ - Stay objective
244
+ - Respect participants
245
+
246
+ ### Analyze Results
247
+ - Organize data
248
+ - Identify patterns
249
+ - Synthesize insights
250
+ - Create deliverables
251
+ - Share findings
252
+
253
+ ## Research Deliverables
254
+
255
+ ### Research Reports
256
+ - Executive summary
257
+ - Methodology
258
+ - Findings
259
+ - Insights
260
+ - Recommendations
261
+
262
+ ### Personas
263
+ - User profiles
264
+ - Characteristics
265
+ - Goals and needs
266
+ - Use cases
267
+
268
+ ### Journey Maps
269
+ - User journeys
270
+ - Touchpoints
271
+ - Pain points
272
+ - Opportunities
273
+
274
+ ### Design Recommendations
275
+ - Actionable insights
276
+ - Design implications
277
+ - Feature priorities
278
+ - Next steps
279
+
280
+ ## Best Practices
281
+
282
+ ### 1. Start Early
283
+ - Research before design
284
+ - Continuous research
285
+ - Iterative approach
286
+ - Early validation
287
+
288
+ ### 2. Mix Methods
289
+ - Qualitative and quantitative
290
+ - Multiple perspectives
291
+ - Triangulate findings
292
+ - Comprehensive understanding
293
+
294
+ ### 3. Involve Stakeholders
295
+ - Share findings
296
+ - Get buy-in
297
+ - Align team
298
+ - Build consensus
299
+
300
+ ### 4. Document Everything
301
+ - Research notes
302
+ - Findings
303
+ - Insights
304
+ - Recommendations
305
+ - Share widely
306
+
307
+ ### 5. Act on Findings
308
+ - Implement insights
309
+ - Prioritize changes
310
+ - Measure impact
311
+ - Iterate based on results
312
+
313
+ ## Common Mistakes
314
+
315
+ ### 1. Not Researching
316
+ - Assuming user needs
317
+ - No validation
318
+ - Design in vacuum
319
+ - Ignoring users
320
+
321
+ ### 2. Biased Research
322
+ - Leading questions
323
+ - Confirmation bias
324
+ - Small sample sizes
325
+ - Unrepresentative users
326
+
327
+ ### 3. Poor Documentation
328
+ - Lost insights
329
+ - Not shared
330
+ - No action
331
+ - Forgotten findings
332
+
333
+ ### 4. Research for Research's Sake
334
+ - No clear objectives
335
+ - Not actionable
336
+ - No follow-up
337
+ - Wasted effort
338
+
339
+ ## Tools and Resources
340
+
341
+ ### Research Tools
342
+ - UserTesting
343
+ - Lookback
344
+ - Dovetail
345
+ - Miro
346
+ - Optimal Workshop
347
+
348
+ ### Analytics Tools
349
+ - Google Analytics
350
+ - Hotjar
351
+ - Mixpanel
352
+ - Amplitude
353
+ - FullStory
354
+
355
+ ### Survey Tools
356
+ - SurveyMonkey
357
+ - Typeform
358
+ - Google Forms
359
+ - Qualtrics
360
+
361
+ ## Best Practices Summary
362
+
363
+ 1. **Start Early**: Research before design
364
+ 2. **Mix Methods**: Qualitative and quantitative
365
+ 3. **User-Centered**: Focus on users
366
+ 4. **Document**: Capture all insights
367
+ 5. **Share**: Communicate findings
368
+ 6. **Act**: Implement recommendations
369
+ 7. **Iterate**: Continuous research
370
+ 8. **Validate**: Test assumptions
371
+ 9. **Measure**: Track success
372
+ 10. **Improve**: Learn and adapt
373
+