claude-mpm 4.21.0__py3-none-any.whl → 5.0.2__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 (497) hide show
  1. claude_mpm/VERSION +1 -1
  2. claude_mpm/agents/BASE_PM.md +12 -0
  3. claude_mpm/agents/OUTPUT_STYLE.md +3 -48
  4. claude_mpm/agents/PM_INSTRUCTIONS.md +632 -334
  5. claude_mpm/agents/WORKFLOW.md +75 -2
  6. claude_mpm/agents/__init__.py +6 -0
  7. claude_mpm/agents/agent_loader.py +1 -4
  8. claude_mpm/agents/base_agent.json +6 -3
  9. claude_mpm/agents/frontmatter_validator.py +1 -1
  10. claude_mpm/agents/templates/{circuit_breakers.md → circuit-breakers.md} +370 -3
  11. claude_mpm/agents/templates/context-management-examples.md +544 -0
  12. claude_mpm/agents/templates/{pm_red_flags.md → pm-red-flags.md} +89 -19
  13. claude_mpm/agents/templates/pr-workflow-examples.md +427 -0
  14. claude_mpm/agents/templates/research-gate-examples.md +669 -0
  15. claude_mpm/agents/templates/structured-questions-examples.md +615 -0
  16. claude_mpm/agents/templates/ticket-completeness-examples.md +139 -0
  17. claude_mpm/agents/templates/ticketing-examples.md +277 -0
  18. claude_mpm/cli/__init__.py +38 -2
  19. claude_mpm/cli/commands/agent_source.py +774 -0
  20. claude_mpm/cli/commands/agent_state_manager.py +125 -20
  21. claude_mpm/cli/commands/agents.py +684 -13
  22. claude_mpm/cli/commands/agents_cleanup.py +210 -0
  23. claude_mpm/cli/commands/agents_discover.py +338 -0
  24. claude_mpm/cli/commands/aggregate.py +1 -1
  25. claude_mpm/cli/commands/analyze.py +3 -3
  26. claude_mpm/cli/commands/auto_configure.py +2 -6
  27. claude_mpm/cli/commands/cleanup.py +1 -1
  28. claude_mpm/cli/commands/config.py +7 -4
  29. claude_mpm/cli/commands/configure.py +478 -44
  30. claude_mpm/cli/commands/configure_agent_display.py +4 -4
  31. claude_mpm/cli/commands/configure_navigation.py +63 -46
  32. claude_mpm/cli/commands/debug.py +12 -12
  33. claude_mpm/cli/commands/doctor.py +10 -2
  34. claude_mpm/cli/commands/hook_errors.py +277 -0
  35. claude_mpm/cli/commands/local_deploy.py +1 -4
  36. claude_mpm/cli/commands/mcp_install_commands.py +1 -1
  37. claude_mpm/cli/commands/mpm_init/core.py +50 -2
  38. claude_mpm/cli/commands/mpm_init/git_activity.py +10 -10
  39. claude_mpm/cli/commands/mpm_init/prompts.py +6 -6
  40. claude_mpm/cli/commands/run.py +124 -128
  41. claude_mpm/cli/commands/skill_source.py +694 -0
  42. claude_mpm/cli/commands/skills.py +435 -1
  43. claude_mpm/cli/executor.py +78 -3
  44. claude_mpm/cli/interactive/agent_wizard.py +919 -41
  45. claude_mpm/cli/parsers/agent_source_parser.py +171 -0
  46. claude_mpm/cli/parsers/agents_parser.py +173 -4
  47. claude_mpm/cli/parsers/base_parser.py +49 -0
  48. claude_mpm/cli/parsers/config_parser.py +96 -43
  49. claude_mpm/cli/parsers/skill_source_parser.py +169 -0
  50. claude_mpm/cli/parsers/skills_parser.py +138 -0
  51. claude_mpm/cli/parsers/source_parser.py +138 -0
  52. claude_mpm/cli/startup.py +499 -84
  53. claude_mpm/cli/startup_display.py +480 -0
  54. claude_mpm/cli/utils.py +1 -1
  55. claude_mpm/cli_module/commands.py +1 -1
  56. claude_mpm/commands/{mpm-auto-configure.md → mpm-agents-auto-configure.md} +9 -0
  57. claude_mpm/commands/mpm-agents-detect.md +9 -0
  58. claude_mpm/commands/{mpm-agents.md → mpm-agents-list.md} +9 -0
  59. claude_mpm/commands/mpm-agents-recommend.md +9 -0
  60. claude_mpm/commands/{mpm-config.md → mpm-config-view.md} +9 -0
  61. claude_mpm/commands/mpm-doctor.md +9 -0
  62. claude_mpm/commands/mpm-help.md +14 -2
  63. claude_mpm/commands/mpm-init.md +27 -2
  64. claude_mpm/commands/mpm-monitor.md +9 -0
  65. claude_mpm/commands/mpm-session-resume.md +381 -0
  66. claude_mpm/commands/mpm-status.md +9 -0
  67. claude_mpm/commands/{mpm-organize.md → mpm-ticket-organize.md} +9 -0
  68. claude_mpm/commands/mpm-ticket-view.md +552 -0
  69. claude_mpm/commands/mpm-version.md +9 -0
  70. claude_mpm/commands/mpm.md +11 -0
  71. claude_mpm/config/agent_presets.py +258 -0
  72. claude_mpm/config/agent_sources.py +325 -0
  73. claude_mpm/config/skill_sources.py +590 -0
  74. claude_mpm/constants.py +12 -0
  75. claude_mpm/core/api_validator.py +1 -1
  76. claude_mpm/core/claude_runner.py +17 -10
  77. claude_mpm/core/config.py +24 -0
  78. claude_mpm/core/constants.py +1 -1
  79. claude_mpm/core/framework/__init__.py +3 -16
  80. claude_mpm/core/framework/loaders/instruction_loader.py +25 -5
  81. claude_mpm/core/framework/processors/metadata_processor.py +1 -1
  82. claude_mpm/core/hook_error_memory.py +381 -0
  83. claude_mpm/core/hook_manager.py +41 -2
  84. claude_mpm/core/interactive_session.py +112 -5
  85. claude_mpm/core/logger.py +3 -1
  86. claude_mpm/core/oneshot_session.py +94 -4
  87. claude_mpm/dashboard/static/css/activity.css +69 -69
  88. claude_mpm/dashboard/static/css/connection-status.css +10 -10
  89. claude_mpm/dashboard/static/css/dashboard.css +15 -15
  90. claude_mpm/dashboard/static/js/components/activity-tree.js +178 -178
  91. claude_mpm/dashboard/static/js/components/agent-hierarchy.js +101 -101
  92. claude_mpm/dashboard/static/js/components/agent-inference.js +31 -31
  93. claude_mpm/dashboard/static/js/components/build-tracker.js +59 -59
  94. claude_mpm/dashboard/static/js/components/code-simple.js +107 -107
  95. claude_mpm/dashboard/static/js/components/connection-debug.js +101 -101
  96. claude_mpm/dashboard/static/js/components/diff-viewer.js +113 -113
  97. claude_mpm/dashboard/static/js/components/event-viewer.js +12 -12
  98. claude_mpm/dashboard/static/js/components/file-change-tracker.js +57 -57
  99. claude_mpm/dashboard/static/js/components/file-change-viewer.js +74 -74
  100. claude_mpm/dashboard/static/js/components/file-tool-tracker.js +6 -6
  101. claude_mpm/dashboard/static/js/components/file-viewer.js +42 -42
  102. claude_mpm/dashboard/static/js/components/module-viewer.js +27 -27
  103. claude_mpm/dashboard/static/js/components/session-manager.js +14 -14
  104. claude_mpm/dashboard/static/js/components/socket-manager.js +1 -1
  105. claude_mpm/dashboard/static/js/components/ui-state-manager.js +14 -14
  106. claude_mpm/dashboard/static/js/components/unified-data-viewer.js +110 -110
  107. claude_mpm/dashboard/static/js/components/working-directory.js +8 -8
  108. claude_mpm/dashboard/static/js/connection-manager.js +76 -76
  109. claude_mpm/dashboard/static/js/dashboard.js +76 -58
  110. claude_mpm/dashboard/static/js/extension-error-handler.js +22 -22
  111. claude_mpm/dashboard/static/js/socket-client.js +138 -121
  112. claude_mpm/dashboard/templates/code_simple.html +23 -23
  113. claude_mpm/dashboard/templates/index.html +18 -18
  114. claude_mpm/experimental/cli_enhancements.py +1 -5
  115. claude_mpm/hooks/claude_hooks/event_handlers.py +3 -1
  116. claude_mpm/hooks/claude_hooks/hook_handler.py +24 -7
  117. claude_mpm/hooks/claude_hooks/installer.py +45 -0
  118. claude_mpm/hooks/failure_learning/__init__.py +2 -8
  119. claude_mpm/hooks/failure_learning/failure_detection_hook.py +1 -6
  120. claude_mpm/hooks/failure_learning/fix_detection_hook.py +1 -6
  121. claude_mpm/hooks/failure_learning/learning_extraction_hook.py +1 -6
  122. claude_mpm/hooks/kuzu_response_hook.py +1 -5
  123. claude_mpm/hooks/templates/pre_tool_use_simple.py +78 -0
  124. claude_mpm/hooks/templates/pre_tool_use_template.py +323 -0
  125. claude_mpm/models/git_repository.py +198 -0
  126. claude_mpm/scripts/claude-hook-handler.sh +3 -3
  127. claude_mpm/scripts/start_activity_logging.py +3 -1
  128. claude_mpm/services/agents/agent_builder.py +45 -9
  129. claude_mpm/services/agents/agent_preset_service.py +238 -0
  130. claude_mpm/services/agents/agent_selection_service.py +484 -0
  131. claude_mpm/services/agents/auto_deploy_index_parser.py +569 -0
  132. claude_mpm/services/agents/deployment/agent_deployment.py +126 -2
  133. claude_mpm/services/agents/deployment/agent_discovery_service.py +105 -73
  134. claude_mpm/services/agents/deployment/agent_format_converter.py +1 -1
  135. claude_mpm/services/agents/deployment/agent_lifecycle_manager.py +1 -5
  136. claude_mpm/services/agents/deployment/agent_metrics_collector.py +3 -3
  137. claude_mpm/services/agents/deployment/agent_restore_handler.py +1 -4
  138. claude_mpm/services/agents/deployment/agent_template_builder.py +236 -15
  139. claude_mpm/services/agents/deployment/agents_directory_resolver.py +101 -15
  140. claude_mpm/services/agents/deployment/async_agent_deployment.py +2 -1
  141. claude_mpm/services/agents/deployment/facade/deployment_facade.py +3 -3
  142. claude_mpm/services/agents/deployment/multi_source_deployment_service.py +115 -15
  143. claude_mpm/services/agents/deployment/pipeline/pipeline_executor.py +2 -2
  144. claude_mpm/services/agents/deployment/refactored_agent_deployment_service.py +1 -4
  145. claude_mpm/services/agents/deployment/remote_agent_discovery_service.py +363 -0
  146. claude_mpm/services/agents/deployment/single_agent_deployer.py +2 -2
  147. claude_mpm/services/agents/deployment/system_instructions_deployer.py +168 -46
  148. claude_mpm/services/agents/deployment/validation/deployment_validator.py +2 -2
  149. claude_mpm/services/agents/git_source_manager.py +629 -0
  150. claude_mpm/services/agents/loading/framework_agent_loader.py +9 -12
  151. claude_mpm/services/agents/local_template_manager.py +50 -10
  152. claude_mpm/services/agents/single_tier_deployment_service.py +696 -0
  153. claude_mpm/services/agents/sources/__init__.py +13 -0
  154. claude_mpm/services/agents/sources/agent_sync_state.py +516 -0
  155. claude_mpm/services/agents/sources/git_source_sync_service.py +1055 -0
  156. claude_mpm/services/agents/startup_sync.py +239 -0
  157. claude_mpm/services/agents/toolchain_detector.py +474 -0
  158. claude_mpm/services/cli/session_pause_manager.py +1 -1
  159. claude_mpm/services/cli/unified_dashboard_manager.py +1 -1
  160. claude_mpm/services/command_deployment_service.py +92 -1
  161. claude_mpm/services/core/base.py +26 -11
  162. claude_mpm/services/core/interfaces/__init__.py +1 -3
  163. claude_mpm/services/core/interfaces/health.py +1 -4
  164. claude_mpm/services/core/models/__init__.py +2 -11
  165. claude_mpm/services/diagnostics/checks/__init__.py +4 -0
  166. claude_mpm/services/diagnostics/checks/agent_check.py +0 -2
  167. claude_mpm/services/diagnostics/checks/agent_sources_check.py +577 -0
  168. claude_mpm/services/diagnostics/checks/instructions_check.py +1 -2
  169. claude_mpm/services/diagnostics/checks/mcp_check.py +0 -1
  170. claude_mpm/services/diagnostics/checks/monitor_check.py +0 -1
  171. claude_mpm/services/diagnostics/checks/skill_sources_check.py +587 -0
  172. claude_mpm/services/diagnostics/diagnostic_runner.py +9 -0
  173. claude_mpm/services/diagnostics/doctor_reporter.py +40 -10
  174. claude_mpm/services/event_bus/direct_relay.py +3 -3
  175. claude_mpm/services/event_bus/event_bus.py +36 -3
  176. claude_mpm/services/event_bus/relay.py +23 -7
  177. claude_mpm/services/events/consumers/logging.py +1 -2
  178. claude_mpm/services/git/__init__.py +21 -0
  179. claude_mpm/services/git/git_operations_service.py +494 -0
  180. claude_mpm/services/github/__init__.py +21 -0
  181. claude_mpm/services/github/github_cli_service.py +397 -0
  182. claude_mpm/services/infrastructure/monitoring/__init__.py +1 -5
  183. claude_mpm/services/infrastructure/monitoring/aggregator.py +1 -6
  184. claude_mpm/services/infrastructure/monitoring/resources.py +1 -1
  185. claude_mpm/services/instructions/__init__.py +9 -0
  186. claude_mpm/services/instructions/instruction_cache_service.py +374 -0
  187. claude_mpm/services/local_ops/__init__.py +3 -13
  188. claude_mpm/services/local_ops/health_checks/__init__.py +1 -3
  189. claude_mpm/services/local_ops/health_manager.py +1 -4
  190. claude_mpm/services/local_ops/process_manager.py +1 -1
  191. claude_mpm/services/local_ops/resource_monitor.py +2 -2
  192. claude_mpm/services/mcp_gateway/config/configuration.py +1 -1
  193. claude_mpm/services/mcp_gateway/server/mcp_gateway.py +1 -6
  194. claude_mpm/services/mcp_gateway/server/stdio_server.py +0 -2
  195. claude_mpm/services/mcp_gateway/tools/document_summarizer.py +1 -1
  196. claude_mpm/services/mcp_gateway/tools/kuzu_memory_service.py +6 -2
  197. claude_mpm/services/memory/failure_tracker.py +19 -4
  198. claude_mpm/services/memory/optimizer.py +1 -1
  199. claude_mpm/services/model/model_router.py +8 -9
  200. claude_mpm/services/monitor/daemon.py +1 -1
  201. claude_mpm/services/monitor/server.py +2 -2
  202. claude_mpm/services/native_agent_converter.py +356 -0
  203. claude_mpm/services/port_manager.py +1 -1
  204. claude_mpm/services/pr/__init__.py +14 -0
  205. claude_mpm/services/pr/pr_template_service.py +329 -0
  206. claude_mpm/services/project/documentation_manager.py +2 -1
  207. claude_mpm/services/project/toolchain_analyzer.py +3 -1
  208. claude_mpm/services/runner_configuration_service.py +1 -0
  209. claude_mpm/services/self_upgrade_service.py +165 -7
  210. claude_mpm/services/skills/__init__.py +18 -0
  211. claude_mpm/services/skills/git_skill_source_manager.py +1169 -0
  212. claude_mpm/services/skills/skill_discovery_service.py +568 -0
  213. claude_mpm/services/skills_config.py +547 -0
  214. claude_mpm/services/skills_deployer.py +955 -0
  215. claude_mpm/services/socketio/handlers/connection.py +1 -1
  216. claude_mpm/services/socketio/handlers/git.py +2 -2
  217. claude_mpm/services/socketio/server/core.py +1 -4
  218. claude_mpm/services/socketio/server/main.py +1 -3
  219. claude_mpm/services/system_instructions_service.py +1 -3
  220. claude_mpm/services/unified/analyzer_strategies/performance_analyzer.py +0 -3
  221. claude_mpm/services/unified/analyzer_strategies/security_analyzer.py +0 -1
  222. claude_mpm/services/unified/deployment_strategies/cloud_strategies.py +1 -1
  223. claude_mpm/services/unified/deployment_strategies/vercel.py +1 -5
  224. claude_mpm/services/unified/unified_deployment.py +1 -5
  225. claude_mpm/services/version_control/conflict_resolution.py +6 -4
  226. claude_mpm/services/visualization/__init__.py +1 -5
  227. claude_mpm/services/visualization/mermaid_generator.py +2 -3
  228. claude_mpm/skills/bundled/infrastructure/env-manager/scripts/validate_env.py +576 -0
  229. claude_mpm/skills/bundled/performance-profiling.md +6 -0
  230. claude_mpm/skills/bundled/testing/webapp-testing/scripts/with_server.py +2 -2
  231. claude_mpm/skills/skills_registry.py +0 -1
  232. claude_mpm/templates/questions/__init__.py +38 -0
  233. claude_mpm/templates/questions/base.py +193 -0
  234. claude_mpm/templates/questions/pr_strategy.py +311 -0
  235. claude_mpm/templates/questions/project_init.py +385 -0
  236. claude_mpm/templates/questions/ticket_mgmt.py +394 -0
  237. claude_mpm/tools/__main__.py +8 -8
  238. claude_mpm/tools/code_tree_analyzer/__init__.py +45 -0
  239. claude_mpm/tools/code_tree_analyzer/analysis.py +299 -0
  240. claude_mpm/tools/code_tree_analyzer/cache.py +131 -0
  241. claude_mpm/tools/code_tree_analyzer/core.py +380 -0
  242. claude_mpm/tools/code_tree_analyzer/discovery.py +403 -0
  243. claude_mpm/tools/code_tree_analyzer/events.py +168 -0
  244. claude_mpm/tools/code_tree_analyzer/gitignore.py +308 -0
  245. claude_mpm/tools/code_tree_analyzer/models.py +39 -0
  246. claude_mpm/tools/code_tree_analyzer/multilang_analyzer.py +224 -0
  247. claude_mpm/tools/code_tree_analyzer/python_analyzer.py +284 -0
  248. claude_mpm/utils/agent_dependency_loader.py +80 -13
  249. claude_mpm/utils/dependency_cache.py +3 -1
  250. claude_mpm/utils/gitignore.py +241 -0
  251. claude_mpm/utils/log_cleanup.py +3 -3
  252. claude_mpm/utils/progress.py +383 -0
  253. claude_mpm/utils/robust_installer.py +3 -5
  254. claude_mpm/utils/structured_questions.py +619 -0
  255. {claude_mpm-4.21.0.dist-info → claude_mpm-5.0.2.dist-info}/METADATA +429 -59
  256. {claude_mpm-4.21.0.dist-info → claude_mpm-5.0.2.dist-info}/RECORD +264 -427
  257. claude_mpm/agents/templates/.claude-mpm/memories/README.md +0 -17
  258. claude_mpm/agents/templates/.claude-mpm/memories/engineer_memories.md +0 -3
  259. claude_mpm/agents/templates/agent-manager.json +0 -273
  260. claude_mpm/agents/templates/agentic-coder-optimizer.json +0 -248
  261. claude_mpm/agents/templates/api_qa.json +0 -180
  262. claude_mpm/agents/templates/clerk-ops.json +0 -235
  263. claude_mpm/agents/templates/code_analyzer.json +0 -101
  264. claude_mpm/agents/templates/content-agent.json +0 -358
  265. claude_mpm/agents/templates/dart_engineer.json +0 -307
  266. claude_mpm/agents/templates/data_engineer.json +0 -225
  267. claude_mpm/agents/templates/documentation.json +0 -211
  268. claude_mpm/agents/templates/engineer.json +0 -210
  269. claude_mpm/agents/templates/gcp_ops_agent.json +0 -253
  270. claude_mpm/agents/templates/golang_engineer.json +0 -270
  271. claude_mpm/agents/templates/imagemagick.json +0 -264
  272. claude_mpm/agents/templates/java_engineer.json +0 -346
  273. claude_mpm/agents/templates/local_ops_agent.json +0 -1840
  274. claude_mpm/agents/templates/logs/prompts/agent_engineer_20250826_014258_728.md +0 -39
  275. claude_mpm/agents/templates/logs/prompts/agent_engineer_20250901_010124_142.md +0 -400
  276. claude_mpm/agents/templates/memory_manager.json +0 -158
  277. claude_mpm/agents/templates/nextjs_engineer.json +0 -285
  278. claude_mpm/agents/templates/ops.json +0 -185
  279. claude_mpm/agents/templates/php-engineer.json +0 -287
  280. claude_mpm/agents/templates/product_owner.json +0 -338
  281. claude_mpm/agents/templates/project_organizer.json +0 -140
  282. claude_mpm/agents/templates/prompt-engineer.json +0 -737
  283. claude_mpm/agents/templates/python_engineer.json +0 -387
  284. claude_mpm/agents/templates/qa.json +0 -242
  285. claude_mpm/agents/templates/react_engineer.json +0 -238
  286. claude_mpm/agents/templates/refactoring_engineer.json +0 -276
  287. claude_mpm/agents/templates/research.json +0 -188
  288. claude_mpm/agents/templates/ruby-engineer.json +0 -280
  289. claude_mpm/agents/templates/rust_engineer.json +0 -275
  290. claude_mpm/agents/templates/security.json +0 -202
  291. claude_mpm/agents/templates/svelte-engineer.json +0 -225
  292. claude_mpm/agents/templates/ticketing.json +0 -177
  293. claude_mpm/agents/templates/typescript_engineer.json +0 -285
  294. claude_mpm/agents/templates/vercel_ops_agent.json +0 -412
  295. claude_mpm/agents/templates/version_control.json +0 -157
  296. claude_mpm/agents/templates/web_qa.json +0 -399
  297. claude_mpm/agents/templates/web_ui.json +0 -189
  298. claude_mpm/commands/mpm-tickets.md +0 -102
  299. claude_mpm/dashboard/.claude-mpm/socketio-instances.json +0 -1
  300. claude_mpm/dashboard/react/components/DataInspector/DataInspector.module.css +0 -188
  301. claude_mpm/dashboard/react/components/EventViewer/EventViewer.module.css +0 -156
  302. claude_mpm/dashboard/react/components/shared/ConnectionStatus.module.css +0 -38
  303. claude_mpm/dashboard/react/components/shared/FilterBar.module.css +0 -92
  304. claude_mpm/dashboard/static/archive/activity_dashboard_fixed.html +0 -248
  305. claude_mpm/dashboard/static/archive/activity_dashboard_test.html +0 -61
  306. claude_mpm/dashboard/static/archive/test_activity_connection.html +0 -179
  307. claude_mpm/dashboard/static/archive/test_claude_tree_tab.html +0 -68
  308. claude_mpm/dashboard/static/archive/test_dashboard.html +0 -409
  309. claude_mpm/dashboard/static/archive/test_dashboard_fixed.html +0 -519
  310. claude_mpm/dashboard/static/archive/test_dashboard_verification.html +0 -181
  311. claude_mpm/dashboard/static/archive/test_file_data.html +0 -315
  312. claude_mpm/dashboard/static/archive/test_file_tree_empty_state.html +0 -243
  313. claude_mpm/dashboard/static/archive/test_file_tree_fix.html +0 -234
  314. claude_mpm/dashboard/static/archive/test_file_tree_rename.html +0 -117
  315. claude_mpm/dashboard/static/archive/test_file_tree_tab.html +0 -115
  316. claude_mpm/dashboard/static/archive/test_file_viewer.html +0 -224
  317. claude_mpm/dashboard/static/archive/test_final_activity.html +0 -220
  318. claude_mpm/dashboard/static/archive/test_tab_fix.html +0 -139
  319. claude_mpm/dashboard/static/built/assets/events.DjpNxWNo.css +0 -1
  320. claude_mpm/dashboard/static/built/components/activity-tree.js +0 -2
  321. claude_mpm/dashboard/static/built/components/agent-hierarchy.js +0 -777
  322. claude_mpm/dashboard/static/built/components/agent-inference.js +0 -2
  323. claude_mpm/dashboard/static/built/components/build-tracker.js +0 -333
  324. claude_mpm/dashboard/static/built/components/code-simple.js +0 -857
  325. claude_mpm/dashboard/static/built/components/code-tree/tree-breadcrumb.js +0 -353
  326. claude_mpm/dashboard/static/built/components/code-tree/tree-constants.js +0 -235
  327. claude_mpm/dashboard/static/built/components/code-tree/tree-search.js +0 -409
  328. claude_mpm/dashboard/static/built/components/code-tree/tree-utils.js +0 -435
  329. claude_mpm/dashboard/static/built/components/code-tree.js +0 -2
  330. claude_mpm/dashboard/static/built/components/code-viewer.js +0 -2
  331. claude_mpm/dashboard/static/built/components/connection-debug.js +0 -654
  332. claude_mpm/dashboard/static/built/components/diff-viewer.js +0 -891
  333. claude_mpm/dashboard/static/built/components/event-processor.js +0 -2
  334. claude_mpm/dashboard/static/built/components/event-viewer.js +0 -2
  335. claude_mpm/dashboard/static/built/components/export-manager.js +0 -2
  336. claude_mpm/dashboard/static/built/components/file-change-tracker.js +0 -443
  337. claude_mpm/dashboard/static/built/components/file-change-viewer.js +0 -690
  338. claude_mpm/dashboard/static/built/components/file-tool-tracker.js +0 -2
  339. claude_mpm/dashboard/static/built/components/file-viewer.js +0 -2
  340. claude_mpm/dashboard/static/built/components/hud-library-loader.js +0 -2
  341. claude_mpm/dashboard/static/built/components/hud-manager.js +0 -2
  342. claude_mpm/dashboard/static/built/components/hud-visualizer.js +0 -2
  343. claude_mpm/dashboard/static/built/components/module-viewer.js +0 -2
  344. claude_mpm/dashboard/static/built/components/nav-bar.js +0 -145
  345. claude_mpm/dashboard/static/built/components/page-structure.js +0 -429
  346. claude_mpm/dashboard/static/built/components/session-manager.js +0 -2
  347. claude_mpm/dashboard/static/built/components/socket-manager.js +0 -2
  348. claude_mpm/dashboard/static/built/components/ui-state-manager.js +0 -2
  349. claude_mpm/dashboard/static/built/components/unified-data-viewer.js +0 -2
  350. claude_mpm/dashboard/static/built/components/working-directory.js +0 -2
  351. claude_mpm/dashboard/static/built/connection-manager.js +0 -536
  352. claude_mpm/dashboard/static/built/dashboard.js +0 -2
  353. claude_mpm/dashboard/static/built/extension-error-handler.js +0 -164
  354. claude_mpm/dashboard/static/built/react/events.js +0 -30
  355. claude_mpm/dashboard/static/built/shared/dom-helpers.js +0 -396
  356. claude_mpm/dashboard/static/built/shared/event-bus.js +0 -330
  357. claude_mpm/dashboard/static/built/shared/event-filter-service.js +0 -540
  358. claude_mpm/dashboard/static/built/shared/logger.js +0 -385
  359. claude_mpm/dashboard/static/built/shared/page-structure.js +0 -249
  360. claude_mpm/dashboard/static/built/shared/tooltip-service.js +0 -253
  361. claude_mpm/dashboard/static/built/socket-client.js +0 -2
  362. claude_mpm/dashboard/static/built/tab-isolation-fix.js +0 -185
  363. claude_mpm/dashboard/static/dist/assets/events.DjpNxWNo.css +0 -1
  364. claude_mpm/dashboard/static/dist/components/activity-tree.js +0 -2
  365. claude_mpm/dashboard/static/dist/components/agent-inference.js +0 -2
  366. claude_mpm/dashboard/static/dist/components/code-tree.js +0 -2
  367. claude_mpm/dashboard/static/dist/components/code-viewer.js +0 -2
  368. claude_mpm/dashboard/static/dist/components/event-processor.js +0 -2
  369. claude_mpm/dashboard/static/dist/components/event-viewer.js +0 -2
  370. claude_mpm/dashboard/static/dist/components/export-manager.js +0 -2
  371. claude_mpm/dashboard/static/dist/components/file-tool-tracker.js +0 -2
  372. claude_mpm/dashboard/static/dist/components/file-viewer.js +0 -2
  373. claude_mpm/dashboard/static/dist/components/hud-library-loader.js +0 -2
  374. claude_mpm/dashboard/static/dist/components/hud-manager.js +0 -2
  375. claude_mpm/dashboard/static/dist/components/hud-visualizer.js +0 -2
  376. claude_mpm/dashboard/static/dist/components/module-viewer.js +0 -2
  377. claude_mpm/dashboard/static/dist/components/session-manager.js +0 -2
  378. claude_mpm/dashboard/static/dist/components/socket-manager.js +0 -2
  379. claude_mpm/dashboard/static/dist/components/ui-state-manager.js +0 -2
  380. claude_mpm/dashboard/static/dist/components/unified-data-viewer.js +0 -2
  381. claude_mpm/dashboard/static/dist/components/working-directory.js +0 -2
  382. claude_mpm/dashboard/static/dist/dashboard.js +0 -2
  383. claude_mpm/dashboard/static/dist/react/events.js +0 -30
  384. claude_mpm/dashboard/static/dist/socket-client.js +0 -2
  385. claude_mpm/dashboard/static/events.html +0 -607
  386. claude_mpm/dashboard/static/index.html +0 -635
  387. claude_mpm/dashboard/static/js/shared/dom-helpers.js +0 -396
  388. claude_mpm/dashboard/static/js/shared/event-bus.js +0 -330
  389. claude_mpm/dashboard/static/js/shared/logger.js +0 -385
  390. claude_mpm/dashboard/static/js/shared/tooltip-service.js +0 -253
  391. claude_mpm/dashboard/static/js/stores/dashboard-store.js +0 -562
  392. claude_mpm/dashboard/static/legacy/activity.html +0 -736
  393. claude_mpm/dashboard/static/legacy/agents.html +0 -786
  394. claude_mpm/dashboard/static/legacy/files.html +0 -747
  395. claude_mpm/dashboard/static/legacy/tools.html +0 -831
  396. claude_mpm/dashboard/static/monitors.html +0 -431
  397. claude_mpm/dashboard/static/production/events.html +0 -659
  398. claude_mpm/dashboard/static/production/main.html +0 -698
  399. claude_mpm/dashboard/static/production/monitors.html +0 -483
  400. claude_mpm/dashboard/static/test-archive/dashboard.html +0 -635
  401. claude_mpm/dashboard/static/test-archive/debug-events.html +0 -147
  402. claude_mpm/dashboard/static/test-archive/test-navigation.html +0 -256
  403. claude_mpm/dashboard/static/test-archive/test-react-exports.html +0 -180
  404. claude_mpm/dashboard/static/test-archive/test_debug.html +0 -25
  405. claude_mpm/skills/bundled/collaboration/brainstorming/SKILL.md +0 -79
  406. claude_mpm/skills/bundled/collaboration/dispatching-parallel-agents/SKILL.md +0 -178
  407. claude_mpm/skills/bundled/collaboration/dispatching-parallel-agents/references/agent-prompts.md +0 -577
  408. claude_mpm/skills/bundled/collaboration/dispatching-parallel-agents/references/coordination-patterns.md +0 -467
  409. claude_mpm/skills/bundled/collaboration/dispatching-parallel-agents/references/examples.md +0 -537
  410. claude_mpm/skills/bundled/collaboration/dispatching-parallel-agents/references/troubleshooting.md +0 -730
  411. claude_mpm/skills/bundled/collaboration/requesting-code-review/SKILL.md +0 -112
  412. claude_mpm/skills/bundled/collaboration/requesting-code-review/references/code-reviewer-template.md +0 -146
  413. claude_mpm/skills/bundled/collaboration/requesting-code-review/references/review-examples.md +0 -412
  414. claude_mpm/skills/bundled/collaboration/writing-plans/SKILL.md +0 -81
  415. claude_mpm/skills/bundled/collaboration/writing-plans/references/best-practices.md +0 -362
  416. claude_mpm/skills/bundled/collaboration/writing-plans/references/plan-structure-templates.md +0 -312
  417. claude_mpm/skills/bundled/debugging/root-cause-tracing/SKILL.md +0 -152
  418. claude_mpm/skills/bundled/debugging/root-cause-tracing/references/advanced-techniques.md +0 -668
  419. claude_mpm/skills/bundled/debugging/root-cause-tracing/references/examples.md +0 -587
  420. claude_mpm/skills/bundled/debugging/root-cause-tracing/references/integration.md +0 -438
  421. claude_mpm/skills/bundled/debugging/root-cause-tracing/references/tracing-techniques.md +0 -391
  422. claude_mpm/skills/bundled/debugging/systematic-debugging/CREATION-LOG.md +0 -119
  423. claude_mpm/skills/bundled/debugging/systematic-debugging/SKILL.md +0 -148
  424. claude_mpm/skills/bundled/debugging/systematic-debugging/references/anti-patterns.md +0 -483
  425. claude_mpm/skills/bundled/debugging/systematic-debugging/references/examples.md +0 -452
  426. claude_mpm/skills/bundled/debugging/systematic-debugging/references/troubleshooting.md +0 -449
  427. claude_mpm/skills/bundled/debugging/systematic-debugging/references/workflow.md +0 -411
  428. claude_mpm/skills/bundled/debugging/systematic-debugging/test-academic.md +0 -14
  429. claude_mpm/skills/bundled/debugging/systematic-debugging/test-pressure-1.md +0 -58
  430. claude_mpm/skills/bundled/debugging/systematic-debugging/test-pressure-2.md +0 -68
  431. claude_mpm/skills/bundled/debugging/systematic-debugging/test-pressure-3.md +0 -69
  432. claude_mpm/skills/bundled/debugging/verification-before-completion/SKILL.md +0 -131
  433. claude_mpm/skills/bundled/debugging/verification-before-completion/references/gate-function.md +0 -325
  434. claude_mpm/skills/bundled/debugging/verification-before-completion/references/integration-and-workflows.md +0 -490
  435. claude_mpm/skills/bundled/debugging/verification-before-completion/references/red-flags-and-failures.md +0 -425
  436. claude_mpm/skills/bundled/debugging/verification-before-completion/references/verification-patterns.md +0 -499
  437. claude_mpm/skills/bundled/main/artifacts-builder/SKILL.md +0 -86
  438. claude_mpm/skills/bundled/main/internal-comms/SKILL.md +0 -43
  439. claude_mpm/skills/bundled/main/internal-comms/examples/3p-updates.md +0 -47
  440. claude_mpm/skills/bundled/main/internal-comms/examples/company-newsletter.md +0 -65
  441. claude_mpm/skills/bundled/main/internal-comms/examples/faq-answers.md +0 -30
  442. claude_mpm/skills/bundled/main/internal-comms/examples/general-comms.md +0 -16
  443. claude_mpm/skills/bundled/main/mcp-builder/SKILL.md +0 -160
  444. claude_mpm/skills/bundled/main/mcp-builder/reference/design_principles.md +0 -412
  445. claude_mpm/skills/bundled/main/mcp-builder/reference/evaluation.md +0 -602
  446. claude_mpm/skills/bundled/main/mcp-builder/reference/mcp_best_practices.md +0 -915
  447. claude_mpm/skills/bundled/main/mcp-builder/reference/node_mcp_server.md +0 -916
  448. claude_mpm/skills/bundled/main/mcp-builder/reference/python_mcp_server.md +0 -752
  449. claude_mpm/skills/bundled/main/mcp-builder/reference/workflow.md +0 -1237
  450. claude_mpm/skills/bundled/main/skill-creator/SKILL.md +0 -189
  451. claude_mpm/skills/bundled/main/skill-creator/references/best-practices.md +0 -500
  452. claude_mpm/skills/bundled/main/skill-creator/references/creation-workflow.md +0 -464
  453. claude_mpm/skills/bundled/main/skill-creator/references/examples.md +0 -619
  454. claude_mpm/skills/bundled/main/skill-creator/references/progressive-disclosure.md +0 -437
  455. claude_mpm/skills/bundled/main/skill-creator/references/skill-structure.md +0 -231
  456. claude_mpm/skills/bundled/php/espocrm-development/SKILL.md +0 -170
  457. claude_mpm/skills/bundled/php/espocrm-development/references/architecture.md +0 -602
  458. claude_mpm/skills/bundled/php/espocrm-development/references/common-tasks.md +0 -821
  459. claude_mpm/skills/bundled/php/espocrm-development/references/development-workflow.md +0 -742
  460. claude_mpm/skills/bundled/php/espocrm-development/references/frontend-customization.md +0 -726
  461. claude_mpm/skills/bundled/php/espocrm-development/references/hooks-and-services.md +0 -764
  462. claude_mpm/skills/bundled/php/espocrm-development/references/testing-debugging.md +0 -831
  463. claude_mpm/skills/bundled/rust/desktop-applications/SKILL.md +0 -226
  464. claude_mpm/skills/bundled/rust/desktop-applications/references/architecture-patterns.md +0 -901
  465. claude_mpm/skills/bundled/rust/desktop-applications/references/native-gui-frameworks.md +0 -901
  466. claude_mpm/skills/bundled/rust/desktop-applications/references/platform-integration.md +0 -775
  467. claude_mpm/skills/bundled/rust/desktop-applications/references/state-management.md +0 -937
  468. claude_mpm/skills/bundled/rust/desktop-applications/references/tauri-framework.md +0 -770
  469. claude_mpm/skills/bundled/rust/desktop-applications/references/testing-deployment.md +0 -961
  470. claude_mpm/skills/bundled/testing/condition-based-waiting/SKILL.md +0 -119
  471. claude_mpm/skills/bundled/testing/condition-based-waiting/references/patterns-and-implementation.md +0 -253
  472. claude_mpm/skills/bundled/testing/test-driven-development/SKILL.md +0 -145
  473. claude_mpm/skills/bundled/testing/test-driven-development/references/anti-patterns.md +0 -543
  474. claude_mpm/skills/bundled/testing/test-driven-development/references/examples.md +0 -741
  475. claude_mpm/skills/bundled/testing/test-driven-development/references/integration.md +0 -470
  476. claude_mpm/skills/bundled/testing/test-driven-development/references/philosophy.md +0 -458
  477. claude_mpm/skills/bundled/testing/test-driven-development/references/workflow.md +0 -639
  478. claude_mpm/skills/bundled/testing/testing-anti-patterns/SKILL.md +0 -140
  479. claude_mpm/skills/bundled/testing/testing-anti-patterns/references/completeness-anti-patterns.md +0 -572
  480. claude_mpm/skills/bundled/testing/testing-anti-patterns/references/core-anti-patterns.md +0 -411
  481. claude_mpm/skills/bundled/testing/testing-anti-patterns/references/detection-guide.md +0 -569
  482. claude_mpm/skills/bundled/testing/testing-anti-patterns/references/tdd-connection.md +0 -695
  483. claude_mpm/skills/bundled/testing/webapp-testing/SKILL.md +0 -184
  484. claude_mpm/skills/bundled/testing/webapp-testing/decision-tree.md +0 -459
  485. claude_mpm/skills/bundled/testing/webapp-testing/playwright-patterns.md +0 -479
  486. claude_mpm/skills/bundled/testing/webapp-testing/reconnaissance-pattern.md +0 -687
  487. claude_mpm/skills/bundled/testing/webapp-testing/server-management.md +0 -758
  488. claude_mpm/skills/bundled/testing/webapp-testing/troubleshooting.md +0 -868
  489. claude_mpm/tools/code_tree_analyzer.py +0 -1825
  490. /claude_mpm/agents/templates/{git_file_tracking.md → git-file-tracking.md} +0 -0
  491. /claude_mpm/agents/templates/{pm_examples.md → pm-examples.md} +0 -0
  492. /claude_mpm/agents/templates/{response_format.md → response-format.md} +0 -0
  493. /claude_mpm/agents/templates/{validation_templates.md → validation-templates.md} +0 -0
  494. {claude_mpm-4.21.0.dist-info → claude_mpm-5.0.2.dist-info}/WHEEL +0 -0
  495. {claude_mpm-4.21.0.dist-info → claude_mpm-5.0.2.dist-info}/entry_points.txt +0 -0
  496. {claude_mpm-4.21.0.dist-info → claude_mpm-5.0.2.dist-info}/licenses/LICENSE +0 -0
  497. {claude_mpm-4.21.0.dist-info → claude_mpm-5.0.2.dist-info}/top_level.txt +0 -0
@@ -1,961 +0,0 @@
1
- # Testing and Deployment
2
-
3
- Complete guide to testing strategies, cross-platform builds, distribution, and CI/CD pipelines for Rust desktop applications.
4
-
5
- ## Testing Strategies
6
-
7
- ### Unit Testing Tauri Commands
8
-
9
- ```rust
10
- // src/commands.rs
11
- use serde::{Deserialize, Serialize};
12
-
13
- #[derive(Debug, Clone, Serialize, Deserialize)]
14
- pub struct User {
15
- pub id: u64,
16
- pub name: String,
17
- pub email: String,
18
- }
19
-
20
- pub struct UserService {
21
- users: Vec<User>,
22
- }
23
-
24
- impl UserService {
25
- pub fn new() -> Self {
26
- Self { users: Vec::new() }
27
- }
28
-
29
- pub fn add_user(&mut self, name: String, email: String) -> Result<User, String> {
30
- if name.is_empty() {
31
- return Err("Name cannot be empty".to_string());
32
- }
33
-
34
- if !email.contains('@') {
35
- return Err("Invalid email".to_string());
36
- }
37
-
38
- let user = User {
39
- id: self.users.len() as u64 + 1,
40
- name,
41
- email,
42
- };
43
-
44
- self.users.push(user.clone());
45
- Ok(user)
46
- }
47
-
48
- pub fn get_user(&self, id: u64) -> Option<&User> {
49
- self.users.iter().find(|u| u.id == id)
50
- }
51
-
52
- pub fn get_all_users(&self) -> &[User] {
53
- &self.users
54
- }
55
- }
56
-
57
- #[cfg(test)]
58
- mod tests {
59
- use super::*;
60
-
61
- #[test]
62
- fn test_add_user_success() {
63
- let mut service = UserService::new();
64
- let result = service.add_user("John Doe".to_string(), "john@example.com".to_string());
65
-
66
- assert!(result.is_ok());
67
- let user = result.unwrap();
68
- assert_eq!(user.name, "John Doe");
69
- assert_eq!(user.email, "john@example.com");
70
- assert_eq!(service.get_all_users().len(), 1);
71
- }
72
-
73
- #[test]
74
- fn test_add_user_empty_name() {
75
- let mut service = UserService::new();
76
- let result = service.add_user("".to_string(), "john@example.com".to_string());
77
-
78
- assert!(result.is_err());
79
- assert_eq!(result.unwrap_err(), "Name cannot be empty");
80
- }
81
-
82
- #[test]
83
- fn test_add_user_invalid_email() {
84
- let mut service = UserService::new();
85
- let result = service.add_user("John Doe".to_string(), "invalid-email".to_string());
86
-
87
- assert!(result.is_err());
88
- assert_eq!(result.unwrap_err(), "Invalid email");
89
- }
90
-
91
- #[test]
92
- fn test_get_user() {
93
- let mut service = UserService::new();
94
- service.add_user("John Doe".to_string(), "john@example.com".to_string()).unwrap();
95
-
96
- let user = service.get_user(1);
97
- assert!(user.is_some());
98
- assert_eq!(user.unwrap().name, "John Doe");
99
- }
100
-
101
- #[test]
102
- fn test_get_user_not_found() {
103
- let service = UserService::new();
104
- let user = service.get_user(999);
105
- assert!(user.is_none());
106
- }
107
- }
108
- ```
109
-
110
- ### Integration Testing with Mock State
111
-
112
- ```rust
113
- #[cfg(test)]
114
- mod integration_tests {
115
- use super::*;
116
- use std::sync::Mutex;
117
-
118
- struct TestState {
119
- service: Mutex<UserService>,
120
- }
121
-
122
- fn setup_test_state() -> TestState {
123
- TestState {
124
- service: Mutex::new(UserService::new()),
125
- }
126
- }
127
-
128
- #[test]
129
- fn test_user_workflow() {
130
- let state = setup_test_state();
131
-
132
- // Add multiple users
133
- {
134
- let mut service = state.service.lock().unwrap();
135
- service.add_user("Alice".to_string(), "alice@example.com".to_string()).unwrap();
136
- service.add_user("Bob".to_string(), "bob@example.com".to_string()).unwrap();
137
- }
138
-
139
- // Verify users were added
140
- {
141
- let service = state.service.lock().unwrap();
142
- assert_eq!(service.get_all_users().len(), 2);
143
- }
144
-
145
- // Get specific user
146
- {
147
- let service = state.service.lock().unwrap();
148
- let alice = service.get_user(1);
149
- assert!(alice.is_some());
150
- assert_eq!(alice.unwrap().name, "Alice");
151
- }
152
- }
153
- }
154
- ```
155
-
156
- ### Async Testing with Tokio
157
-
158
- ```rust
159
- #[cfg(test)]
160
- mod async_tests {
161
- use super::*;
162
- use tokio::test;
163
-
164
- #[tokio::test]
165
- async fn test_async_operation() {
166
- let result = fetch_data_async().await;
167
- assert!(result.is_ok());
168
- }
169
-
170
- #[tokio::test]
171
- async fn test_concurrent_operations() {
172
- let futures = vec![
173
- fetch_data_async(),
174
- fetch_data_async(),
175
- fetch_data_async(),
176
- ];
177
-
178
- let results = futures::future::join_all(futures).await;
179
-
180
- assert_eq!(results.len(), 3);
181
- for result in results {
182
- assert!(result.is_ok());
183
- }
184
- }
185
-
186
- async fn fetch_data_async() -> Result<String, String> {
187
- tokio::time::sleep(tokio::time::Duration::from_millis(100)).await;
188
- Ok("data".to_string())
189
- }
190
- }
191
- ```
192
-
193
- ### Testing with Database
194
-
195
- ```rust
196
- #[cfg(test)]
197
- mod database_tests {
198
- use super::*;
199
- use sqlx::SqlitePool;
200
-
201
- async fn setup_test_db() -> SqlitePool {
202
- let pool = SqlitePool::connect(":memory:")
203
- .await
204
- .expect("Failed to create in-memory database");
205
-
206
- // Run migrations
207
- sqlx::query(
208
- "CREATE TABLE users (
209
- id INTEGER PRIMARY KEY,
210
- name TEXT NOT NULL,
211
- email TEXT NOT NULL
212
- )"
213
- )
214
- .execute(&pool)
215
- .await
216
- .expect("Failed to create table");
217
-
218
- pool
219
- }
220
-
221
- #[tokio::test]
222
- async fn test_create_user() {
223
- let pool = setup_test_db().await;
224
-
225
- let result = sqlx::query(
226
- "INSERT INTO users (name, email) VALUES (?, ?)"
227
- )
228
- .bind("John Doe")
229
- .bind("john@example.com")
230
- .execute(&pool)
231
- .await;
232
-
233
- assert!(result.is_ok());
234
-
235
- let count: (i64,) = sqlx::query_as("SELECT COUNT(*) FROM users")
236
- .fetch_one(&pool)
237
- .await
238
- .unwrap();
239
-
240
- assert_eq!(count.0, 1);
241
- }
242
- }
243
- ```
244
-
245
- ## UI Testing Approaches
246
-
247
- ### egui Testing
248
-
249
- ```rust
250
- #[cfg(test)]
251
- mod ui_tests {
252
- use super::*;
253
- use eframe::egui;
254
-
255
- #[test]
256
- fn test_ui_state_update() {
257
- let mut app = MyApp::default();
258
-
259
- // Simulate UI interaction
260
- app.counter = 0;
261
-
262
- // Trigger button click logic
263
- app.counter += 1;
264
-
265
- assert_eq!(app.counter, 1);
266
- }
267
-
268
- #[test]
269
- fn test_ui_rendering() {
270
- let mut app = MyApp::default();
271
- let ctx = egui::Context::default();
272
-
273
- // Test that UI can be rendered without panic
274
- app.update(&ctx, &mut eframe::Frame::new(eframe::FrameData {
275
- info: eframe::IntegrationInfo::default(),
276
- output: Default::default(),
277
- repaint_signal: std::sync::Arc::new(eframe::RepaintSignal::default()),
278
- }));
279
- }
280
- }
281
- ```
282
-
283
- ### Tauri Frontend-Backend Integration Tests
284
-
285
- ```typescript
286
- // src/tests/integration.test.ts
287
- import { invoke } from '@tauri-apps/api/core';
288
-
289
- describe('User Management', () => {
290
- beforeEach(async () => {
291
- // Reset state
292
- await invoke('reset_users');
293
- });
294
-
295
- test('should add user', async () => {
296
- const user = await invoke<User>('add_user', {
297
- name: 'John Doe',
298
- email: 'john@example.com',
299
- });
300
-
301
- expect(user.name).toBe('John Doe');
302
- expect(user.email).toBe('john@example.com');
303
- });
304
-
305
- test('should reject invalid email', async () => {
306
- await expect(
307
- invoke('add_user', {
308
- name: 'John Doe',
309
- email: 'invalid',
310
- })
311
- ).rejects.toThrow('Invalid email');
312
- });
313
-
314
- test('should get all users', async () => {
315
- await invoke('add_user', {
316
- name: 'Alice',
317
- email: 'alice@example.com',
318
- });
319
-
320
- await invoke('add_user', {
321
- name: 'Bob',
322
- email: 'bob@example.com',
323
- });
324
-
325
- const users = await invoke<User[]>('get_all_users');
326
- expect(users).toHaveLength(2);
327
- });
328
- });
329
- ```
330
-
331
- ### E2E Testing with WebDriver
332
-
333
- ```typescript
334
- // tests/e2e/app.spec.ts
335
- import { test, expect } from '@playwright/test';
336
-
337
- test.describe('Desktop App E2E', () => {
338
- test('should load application', async ({ page }) => {
339
- await page.goto('http://localhost:1420'); // Tauri dev server
340
-
341
- await expect(page.locator('h1')).toContainText('My App');
342
- });
343
-
344
- test('should add user through UI', async ({ page }) => {
345
- await page.goto('http://localhost:1420');
346
-
347
- await page.fill('input[name="name"]', 'John Doe');
348
- await page.fill('input[name="email"]', 'john@example.com');
349
- await page.click('button:has-text("Add User")');
350
-
351
- await expect(page.locator('.user-item')).toContainText('John Doe');
352
- });
353
-
354
- test('should show error for invalid input', async ({ page }) => {
355
- await page.goto('http://localhost:1420');
356
-
357
- await page.fill('input[name="name"]', '');
358
- await page.fill('input[name="email"]', 'invalid');
359
- await page.click('button:has-text("Add User")');
360
-
361
- await expect(page.locator('.error')).toBeVisible();
362
- });
363
- });
364
- ```
365
-
366
- ## Cross-Compilation and Builds
367
-
368
- ### Build Scripts
369
-
370
- ```bash
371
- #!/bin/bash
372
- # scripts/build.sh
373
-
374
- set -e
375
-
376
- TARGET_TRIPLE="${1:-}"
377
- BUILD_TYPE="${2:-release}"
378
-
379
- if [ -z "$TARGET_TRIPLE" ]; then
380
- echo "Building for current platform..."
381
- cargo tauri build
382
- else
383
- echo "Building for $TARGET_TRIPLE..."
384
-
385
- # Install target if needed
386
- rustup target add "$TARGET_TRIPLE"
387
-
388
- # Build
389
- if [ "$BUILD_TYPE" = "debug" ]; then
390
- cargo tauri build --debug --target "$TARGET_TRIPLE"
391
- else
392
- cargo tauri build --target "$TARGET_TRIPLE"
393
- fi
394
- fi
395
-
396
- echo "Build completed successfully!"
397
- ```
398
-
399
- ### Cross-Compilation Setup
400
-
401
- **For Windows from Linux/macOS:**
402
- ```bash
403
- # Install cross-compilation tools
404
- cargo install cargo-xwin
405
-
406
- # Add Windows target
407
- rustup target add x86_64-pc-windows-msvc
408
-
409
- # Build for Windows
410
- cargo xwin build --release --target x86_64-pc-windows-msvc
411
- ```
412
-
413
- **For macOS from Linux:**
414
- ```bash
415
- # Install osxcross (complex setup, see osxcross documentation)
416
- # Add macOS targets
417
- rustup target add x86_64-apple-darwin
418
- rustup target add aarch64-apple-darwin
419
-
420
- # Build for macOS
421
- CROSS_COMPILE=x86_64-apple-darwin- \
422
- cargo build --release --target x86_64-apple-darwin
423
- ```
424
-
425
- **For Linux from macOS/Windows:**
426
- ```bash
427
- # Install cross
428
- cargo install cross
429
-
430
- # Build for Linux
431
- cross build --release --target x86_64-unknown-linux-gnu
432
- ```
433
-
434
- ### Universal Binaries (macOS)
435
-
436
- ```bash
437
- #!/bin/bash
438
- # scripts/build-universal-macos.sh
439
-
440
- set -e
441
-
442
- echo "Building universal macOS binary..."
443
-
444
- # Build for both architectures
445
- cargo tauri build --target x86_64-apple-darwin
446
- cargo tauri build --target aarch64-apple-darwin
447
-
448
- # Create universal binary
449
- lipo -create \
450
- target/x86_64-apple-darwin/release/bundle/macos/MyApp.app/Contents/MacOS/MyApp \
451
- target/aarch64-apple-darwin/release/bundle/macos/MyApp.app/Contents/MacOS/MyApp \
452
- -output target/universal-apple-darwin/release/MyApp
453
-
454
- echo "Universal binary created!"
455
- ```
456
-
457
- ## Platform-Specific Installers
458
-
459
- ### Windows Installer (WiX)
460
-
461
- **wix/main.wxs:**
462
- ```xml
463
- <?xml version="1.0" encoding="UTF-8"?>
464
- <Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">
465
- <Product
466
- Id="*"
467
- Name="My Application"
468
- Language="1033"
469
- Version="1.0.0"
470
- Manufacturer="My Company"
471
- UpgradeCode="PUT-GUID-HERE">
472
-
473
- <Package
474
- InstallerVersion="200"
475
- Compressed="yes"
476
- InstallScope="perMachine" />
477
-
478
- <MajorUpgrade
479
- DowngradeErrorMessage="A newer version is already installed." />
480
-
481
- <MediaTemplate EmbedCab="yes" />
482
-
483
- <Feature
484
- Id="MainApplication"
485
- Title="My Application"
486
- Level="1">
487
- <ComponentGroupRef Id="AppFiles" />
488
- </Feature>
489
-
490
- <Directory Id="TARGETDIR" Name="SourceDir">
491
- <Directory Id="ProgramFilesFolder">
492
- <Directory Id="INSTALLFOLDER" Name="MyApp" />
493
- </Directory>
494
- <Directory Id="ProgramMenuFolder">
495
- <Directory Id="ApplicationProgramsFolder" Name="MyApp"/>
496
- </Directory>
497
- </Directory>
498
-
499
- <ComponentGroup Id="AppFiles" Directory="INSTALLFOLDER">
500
- <Component Id="MainExecutable">
501
- <File
502
- Id="MainExe"
503
- Source="$(var.SourceDir)\MyApp.exe"
504
- KeyPath="yes">
505
- <Shortcut
506
- Id="ApplicationStartMenuShortcut"
507
- Directory="ApplicationProgramsFolder"
508
- Name="MyApp"
509
- Description="My Application"
510
- WorkingDirectory="INSTALLFOLDER"
511
- Icon="AppIcon.exe"
512
- IconIndex="0"
513
- Advertise="yes" />
514
- </File>
515
- </Component>
516
- </ComponentGroup>
517
- </Product>
518
- </Wix>
519
- ```
520
-
521
- ### macOS DMG Creation
522
-
523
- ```bash
524
- #!/bin/bash
525
- # scripts/create-dmg.sh
526
-
527
- set -e
528
-
529
- APP_NAME="MyApp"
530
- VERSION="1.0.0"
531
- DMG_NAME="${APP_NAME}-${VERSION}.dmg"
532
- SOURCE_FOLDER="target/release/bundle/macos/${APP_NAME}.app"
533
- DMG_FOLDER="dmg_temp"
534
-
535
- echo "Creating DMG for ${APP_NAME}..."
536
-
537
- # Create temporary folder
538
- mkdir -p "$DMG_FOLDER"
539
-
540
- # Copy app
541
- cp -R "$SOURCE_FOLDER" "$DMG_FOLDER/"
542
-
543
- # Create symbolic link to Applications
544
- ln -s /Applications "$DMG_FOLDER/Applications"
545
-
546
- # Create DMG
547
- hdiutil create -volname "$APP_NAME" \
548
- -srcfolder "$DMG_FOLDER" \
549
- -ov \
550
- -format UDZO \
551
- "$DMG_NAME"
552
-
553
- # Cleanup
554
- rm -rf "$DMG_FOLDER"
555
-
556
- echo "DMG created: $DMG_NAME"
557
- ```
558
-
559
- ### Linux Packages
560
-
561
- **Debian Package (.deb):**
562
- ```bash
563
- #!/bin/bash
564
- # scripts/build-deb.sh
565
-
566
- set -e
567
-
568
- APP_NAME="myapp"
569
- VERSION="1.0.0"
570
- ARCH="amd64"
571
-
572
- DEB_DIR="target/debian"
573
- mkdir -p "$DEB_DIR/DEBIAN"
574
- mkdir -p "$DEB_DIR/usr/bin"
575
- mkdir -p "$DEB_DIR/usr/share/applications"
576
- mkdir -p "$DEB_DIR/usr/share/icons/hicolor/256x256/apps"
577
-
578
- # Create control file
579
- cat > "$DEB_DIR/DEBIAN/control" << EOF
580
- Package: $APP_NAME
581
- Version: $VERSION
582
- Section: utils
583
- Priority: optional
584
- Architecture: $ARCH
585
- Maintainer: Your Name <your@email.com>
586
- Description: My Application
587
- A desktop application built with Tauri
588
- EOF
589
-
590
- # Copy binary
591
- cp "target/release/$APP_NAME" "$DEB_DIR/usr/bin/"
592
-
593
- # Create desktop entry
594
- cat > "$DEB_DIR/usr/share/applications/$APP_NAME.desktop" << EOF
595
- [Desktop Entry]
596
- Name=My App
597
- Exec=/usr/bin/$APP_NAME
598
- Icon=$APP_NAME
599
- Type=Application
600
- Categories=Utility;
601
- EOF
602
-
603
- # Copy icon
604
- cp "icons/icon.png" "$DEB_DIR/usr/share/icons/hicolor/256x256/apps/$APP_NAME.png"
605
-
606
- # Build package
607
- dpkg-deb --build "$DEB_DIR" "${APP_NAME}_${VERSION}_${ARCH}.deb"
608
-
609
- echo "Debian package created!"
610
- ```
611
-
612
- **AppImage:**
613
- ```bash
614
- #!/bin/bash
615
- # scripts/build-appimage.sh
616
-
617
- set -e
618
-
619
- APP_NAME="MyApp"
620
- APPDIR="AppDir"
621
-
622
- # Create AppDir structure
623
- mkdir -p "$APPDIR/usr/bin"
624
- mkdir -p "$APPDIR/usr/share/applications"
625
- mkdir -p "$APPDIR/usr/share/icons/hicolor/256x256/apps"
626
-
627
- # Copy files
628
- cp "target/release/myapp" "$APPDIR/usr/bin/"
629
- cp "myapp.desktop" "$APPDIR/usr/share/applications/"
630
- cp "icons/icon.png" "$APPDIR/usr/share/icons/hicolor/256x256/apps/myapp.png"
631
-
632
- # Create AppRun
633
- cat > "$APPDIR/AppRun" << 'EOF'
634
- #!/bin/bash
635
- SELF=$(readlink -f "$0")
636
- HERE=${SELF%/*}
637
- export PATH="${HERE}/usr/bin:${PATH}"
638
- exec "${HERE}/usr/bin/myapp" "$@"
639
- EOF
640
- chmod +x "$APPDIR/AppRun"
641
-
642
- # Download appimagetool
643
- wget -O appimagetool "https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage"
644
- chmod +x appimagetool
645
-
646
- # Build AppImage
647
- ./appimagetool "$APPDIR" "${APP_NAME}.AppImage"
648
-
649
- echo "AppImage created!"
650
- ```
651
-
652
- ## Code Signing and Notarization
653
-
654
- ### macOS Code Signing
655
-
656
- ```bash
657
- #!/bin/bash
658
- # scripts/sign-macos.sh
659
-
660
- set -e
661
-
662
- APP_PATH="$1"
663
- IDENTITY="Developer ID Application: Your Name (TEAMID)"
664
-
665
- echo "Signing $APP_PATH..."
666
-
667
- # Sign all frameworks and dylibs first
668
- find "$APP_PATH/Contents" -name "*.framework" -or -name "*.dylib" | while read file; do
669
- codesign --force --sign "$IDENTITY" \
670
- --options runtime \
671
- --timestamp \
672
- "$file"
673
- done
674
-
675
- # Sign the app bundle
676
- codesign --force --deep --sign "$IDENTITY" \
677
- --options runtime \
678
- --entitlements entitlements.plist \
679
- --timestamp \
680
- "$APP_PATH"
681
-
682
- # Verify signature
683
- codesign --verify --verbose=4 "$APP_PATH"
684
-
685
- echo "Signing completed!"
686
- ```
687
-
688
- **entitlements.plist:**
689
- ```xml
690
- <?xml version="1.0" encoding="UTF-8"?>
691
- <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
692
- <plist version="1.0">
693
- <dict>
694
- <key>com.apple.security.cs.allow-unsigned-executable-memory</key>
695
- <true/>
696
- <key>com.apple.security.cs.allow-jit</key>
697
- <true/>
698
- <key>com.apple.security.cs.disable-library-validation</key>
699
- <true/>
700
- </dict>
701
- </plist>
702
- ```
703
-
704
- ### macOS Notarization
705
-
706
- ```bash
707
- #!/bin/bash
708
- # scripts/notarize-macos.sh
709
-
710
- set -e
711
-
712
- APP_PATH="$1"
713
- BUNDLE_ID="com.yourcompany.myapp"
714
- APPLE_ID="your@email.com"
715
- TEAM_ID="TEAMID"
716
- APP_SPECIFIC_PASSWORD="xxxx-xxxx-xxxx-xxxx"
717
-
718
- # Create DMG
719
- DMG_PATH="MyApp.dmg"
720
- hdiutil create -volname "MyApp" \
721
- -srcfolder "$APP_PATH" \
722
- -ov \
723
- -format UDZO \
724
- "$DMG_PATH"
725
-
726
- # Submit for notarization
727
- echo "Submitting for notarization..."
728
- xcrun notarytool submit "$DMG_PATH" \
729
- --apple-id "$APPLE_ID" \
730
- --team-id "$TEAM_ID" \
731
- --password "$APP_SPECIFIC_PASSWORD" \
732
- --wait
733
-
734
- # Staple the ticket
735
- echo "Stapling ticket..."
736
- xcrun stapler staple "$DMG_PATH"
737
-
738
- echo "Notarization completed!"
739
- ```
740
-
741
- ### Windows Code Signing
742
-
743
- ```powershell
744
- # scripts/sign-windows.ps1
745
-
746
- param(
747
- [string]$FilePath,
748
- [string]$CertPath,
749
- [string]$Password
750
- )
751
-
752
- # Sign executable
753
- & "C:\Program Files (x86)\Windows Kits\10\bin\10.0.19041.0\x64\signtool.exe" sign `
754
- /f $CertPath `
755
- /p $Password `
756
- /tr http://timestamp.digicert.com `
757
- /td sha256 `
758
- /fd sha256 `
759
- $FilePath
760
-
761
- # Verify signature
762
- & "C:\Program Files (x86)\Windows Kits\10\bin\10.0.19041.0\x64\signtool.exe" verify /pa $FilePath
763
-
764
- Write-Host "Signing completed!"
765
- ```
766
-
767
- ## CI/CD Pipelines
768
-
769
- ### GitHub Actions Workflow
770
-
771
- ```yaml
772
- # .github/workflows/build.yml
773
- name: Build and Release
774
-
775
- on:
776
- push:
777
- tags:
778
- - 'v*'
779
-
780
- jobs:
781
- build:
782
- strategy:
783
- fail-fast: false
784
- matrix:
785
- platform: [macos-latest, ubuntu-20.04, windows-latest]
786
-
787
- runs-on: ${{ matrix.platform }}
788
-
789
- steps:
790
- - name: Checkout code
791
- uses: actions/checkout@v4
792
-
793
- - name: Setup Node.js
794
- uses: actions/setup-node@v4
795
- with:
796
- node-version: 20
797
-
798
- - name: Setup Rust
799
- uses: dtolnay/rust-toolchain@stable
800
-
801
- - name: Install dependencies (Ubuntu only)
802
- if: matrix.platform == 'ubuntu-20.04'
803
- run: |
804
- sudo apt-get update
805
- sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.0-dev libappindicator3-dev librsvg2-dev patchelf
806
-
807
- - name: Install frontend dependencies
808
- run: npm install
809
-
810
- - name: Build application
811
- run: npm run tauri build
812
-
813
- - name: Upload artifacts
814
- uses: actions/upload-artifact@v4
815
- with:
816
- name: ${{ matrix.platform }}-build
817
- path: |
818
- src-tauri/target/release/bundle/*
819
-
820
- release:
821
- needs: build
822
- runs-on: ubuntu-latest
823
- steps:
824
- - name: Download artifacts
825
- uses: actions/download-artifact@v4
826
-
827
- - name: Create Release
828
- uses: softprops/action-gh-release@v1
829
- with:
830
- files: |
831
- macos-latest-build/**/*
832
- ubuntu-20.04-build/**/*
833
- windows-latest-build/**/*
834
- env:
835
- GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
836
- ```
837
-
838
- ### Multi-Platform Build Matrix
839
-
840
- ```yaml
841
- # .github/workflows/release.yml
842
- name: Release
843
-
844
- on:
845
- workflow_dispatch:
846
- push:
847
- tags:
848
- - 'v*'
849
-
850
- jobs:
851
- build:
852
- strategy:
853
- matrix:
854
- include:
855
- - os: ubuntu-20.04
856
- target: x86_64-unknown-linux-gnu
857
- artifact: deb, appimage
858
- - os: macos-latest
859
- target: x86_64-apple-darwin
860
- artifact: dmg, app
861
- - os: macos-latest
862
- target: aarch64-apple-darwin
863
- artifact: dmg, app
864
- - os: windows-latest
865
- target: x86_64-pc-windows-msvc
866
- artifact: msi, exe
867
-
868
- runs-on: ${{ matrix.os }}
869
-
870
- steps:
871
- - uses: actions/checkout@v4
872
-
873
- - name: Setup Rust
874
- uses: dtolnay/rust-toolchain@stable
875
- with:
876
- targets: ${{ matrix.target }}
877
-
878
- - name: Build
879
- run: cargo tauri build --target ${{ matrix.target }}
880
-
881
- - name: Upload artifacts
882
- uses: actions/upload-artifact@v4
883
- with:
884
- name: ${{ matrix.target }}
885
- path: src-tauri/target/${{ matrix.target }}/release/bundle/
886
- ```
887
-
888
- ### Auto-Update Server
889
-
890
- ```rust
891
- // Simple update server
892
- use actix_web::{web, App, HttpResponse, HttpServer};
893
- use serde::Serialize;
894
-
895
- #[derive(Serialize)]
896
- struct UpdateManifest {
897
- version: String,
898
- notes: String,
899
- pub_date: String,
900
- platforms: Platforms,
901
- }
902
-
903
- #[derive(Serialize)]
904
- struct Platforms {
905
- #[serde(rename = "darwin-x86_64")]
906
- darwin_x86_64: Platform,
907
- #[serde(rename = "darwin-aarch64")]
908
- darwin_aarch64: Platform,
909
- #[serde(rename = "linux-x86_64")]
910
- linux_x86_64: Platform,
911
- #[serde(rename = "windows-x86_64")]
912
- windows_x86_64: Platform,
913
- }
914
-
915
- #[derive(Serialize)]
916
- struct Platform {
917
- signature: String,
918
- url: String,
919
- }
920
-
921
- async fn update_manifest() -> HttpResponse {
922
- let manifest = UpdateManifest {
923
- version: "1.0.1".to_string(),
924
- notes: "Bug fixes and improvements".to_string(),
925
- pub_date: "2024-01-15T00:00:00Z".to_string(),
926
- platforms: Platforms {
927
- darwin_x86_64: Platform {
928
- signature: "BASE64_SIGNATURE".to_string(),
929
- url: "https://releases.myapp.com/myapp-1.0.1-x64.dmg".to_string(),
930
- },
931
- darwin_aarch64: Platform {
932
- signature: "BASE64_SIGNATURE".to_string(),
933
- url: "https://releases.myapp.com/myapp-1.0.1-arm64.dmg".to_string(),
934
- },
935
- linux_x86_64: Platform {
936
- signature: "BASE64_SIGNATURE".to_string(),
937
- url: "https://releases.myapp.com/myapp-1.0.1-amd64.AppImage".to_string(),
938
- },
939
- windows_x86_64: Platform {
940
- signature: "BASE64_SIGNATURE".to_string(),
941
- url: "https://releases.myapp.com/myapp-1.0.1-x64-setup.exe".to_string(),
942
- },
943
- },
944
- };
945
-
946
- HttpResponse::Ok().json(manifest)
947
- }
948
-
949
- #[actix_web::main]
950
- async fn main() -> std::io::Result<()> {
951
- HttpServer::new(|| {
952
- App::new()
953
- .route("/update-manifest.json", web::get().to(update_manifest))
954
- })
955
- .bind(("127.0.0.1", 8080))?
956
- .run()
957
- .await
958
- }
959
- ```
960
-
961
- This comprehensive testing and deployment guide covers everything from unit tests to production CI/CD pipelines, enabling reliable cross-platform distribution of Rust desktop applications.